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PREFACE 



This manual assumes the user has read an introductory book on assembly 
language. It is not intended to teach assembly language. Suggested references 
for assembly language beginners are 6502 Assembly Language Programming by 
Lance Leventhal and Programming the 6502 by Rodney Zaks (see Appendix 8). 

The user should also know how to use the screen editing and control features of 
the ATARI® 400™ and ATARI 800™ Personal Computer Systems. These 
features are the same as used in ATARI BASIC. Review the ATARI BASIC 
Reference Manual if you are unsure of how to do screen editing. 

This manual starts by showing the structure of statements in assembly 
language. The manual then illustrates the different types of 6502 operands. The 
Assembler Editor cartridge contains three separate programs: 

• EDIT (Editor program) — Helps you put programming statements in a form 
the Assembler (ASM) program understands. The EDIT program lets you use 
a printer to print a listing of your program. Programs can also be stored and 
recalled using ENTER, LIST and SAVE, LOAD. The Assembler Editor allows 
automatic numbering, renumbering, delete, find and replace. 

• ASM (Assembler program) — Takes the program statements you create in 
the EDIT step and converts to machine code. 

• DEBUGGER — Helps you trace through the program steps by running the 
program a step at a time while displaying the contents of important internal 
6502 registers. The DEBUGGER program also contains programming 
routines which allow you to display registers, change register contents, 
display memory, change memory contents, move memory, verify memory, 
list memory with disassembly, assemble one instruction into memory, go 
(execute program), exit. The disassembly routine is especially useful in 
reading and understanding machine language code. 

The Assembler Editor cartridge allows you to talk in the computer’s natural 
language — machine language. Assembly language programming offers you 
faster running programs and the ability to tailor programs to your exact needs. 
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INTRODUCTION 



To use (he ATARI® Assembler Editor cartridge effectively, there are four 
kinds of information that you must have. First, you need some guidance about 
how to use the cartridge itself. Second, you need to know about the ATARI 
Personal Computer System you are using with the cartridge. Third, you need to 
know something about 6502 Assembly Language programming. And, fourth, 
the Assembler Editor Cartridge was designed to be used with the ATARI disk 
drives and DOS II. 



this manual explains the operation of the ATARI Assembler Editor cartridge. It 
does not explain 6502 Assembly Language programming. If you are already 
familiar with 6502 Assembly Language, you will find this manual amply suited 
to your needs; otherwise, you should refer to one of the many books that ex- 
plain 6502 Assembly Language programming; suitable books are listed in 
Appendix 8. 

If you are familiar with ATARI BASIC and have written some programs on your 
ATARI 400 IM or ATARI 800™ Personal Computer System, you will find no 
better way to learn assembly language than the combination of this manual, the 
ATARI Assembler Editor cartridge, and a 6502 programming book. 

If you have had no experience with computers and no programming exper- 
ience, then this manual is probably too advanced for you and you should start 
by writing some programs using ATARI BASIC and your ATARI Personal Com- 
puter System to become familiar with programming in general. Reading one of 
the books recommended in Appendix 8 will help you learn assembly language. 



The ATARI Assembler Editor cartridge is installed in the cartridge slot of the 
ATARI 400 computer console and in the left cartridge slot of the ATARI 800 
computer console. You must be familiar with the keyboard and all the screen- 
editing functions. That material is covered in the appropriate Operator’s Manual 
supplied with your ATARI Personal Computer System. The special screen- 
editing keys are described in Section 6 of the Operator’s Manual. You should 
read Section 6 and follow the instructions until you are completely familiar with 
the keyboard and the screen-editing functions. 

You need not have any equipment except the ATARI Personal Computer System 
console, your television or a video monitor for display, and the ATARI 
Assembler Editor cartridge. However, without a permanent storage device you 
will have to enter your program on the keyboard each time you wish to use it. 
This can be tedious and time-consuming. An ATARI 410™ Program Recorder, 
ATARI 810™ Disk Drive, or ATARI 815™ Dual Disk Drive (double density) is a 
practical necessity. 
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The ATARI 410 Program Recorder is an accessory that functions with the 
ATARI 400 and the ATARI 800 Personal Computer Systems. The proper opera- 
tion of your Program Recorder is explained in Section 8 of the ATARI 400 and 
ATARI" 800 Operator’s Manuals. Before using the Program Recorder with the 
Assembler Editor cartridge, be sure you know how to operate the Program 
Recorder. The disk drives are accessories that function with any ATARI Per- 
sonal Computer System with at least 16K RAM. To use a disk drive you need a 
special program, the Disk Operating System (DOS). At least 16K of memory is 
required to accommodate DOS. Consequently, if you are using an ATARI 400 
Personal Computer System, you must upgrade it from 8K to 16K (RAM). This can 
be done at any ATARI Service Center. 



If you are using the ATARI 810 Disk Drive, you should refer to the instructions 
that come with it. You should also read the appropriate Disk Operating System 
Reference Manual. If you are currently using the 9/24/79 version of DOS (DOS I), 
you must use the program in Appendix 11 for the disk drive to be compatible 
with the Assembler Editor cartridge. 

If you are using the ATARI 815 Dual Disk Drive, you should refer to the ATARI 
815 Operator’s Manual and the Disk Operating System II Reference Manual that 
come with it. 



You can also add the ATARI 820™, the ATARI 825™ or the ATARI 822™ Printer 
to your Personal Computer System to give you “hard copy”— that is, a perma- 
nent record of your program written on paper. 



HOW AN 
ASSEMBLER 
EDITOR IS USED 



All assembly language programs are divided into two parts: a “source 
program,” which is a human-readable version of the program, and the “object 
program,” which is the computer-readable version of the program. These two 
versions of the program are distinct and must occupy different areas of RAM. 
As the programmer, you have three primary tasks: 



• To enter your source program into the computer, edit it (make insertions, 
deletions, and corrections) and save it to or retrieve it from diskette or 
cassette. 

• To translate your source code into object code. 

• To monitor and debug the operation of your object program. 



These three tasks are handled with three programs included in the ATARI 
Assembler Editor. The first program, called the Editor, provides many handy 
features for entering the program and making insertions, deletions, and correc- 
tions to it. It also allows you to save and retrieve yoiar source code. The second 
program, called the Assembler, will translate your source program into an 
object program. While doing so, it will provide you with an “assembly listing,” 
a useful listing in which your source program is lined up side by side with the 
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resulting object program. The third program is called the Debugger; it helps 
you to monitor and debug your object program. The relationship between these 
three programs is depicted as follows: 



-YOU 



Editor 

r 

Source Program 




Figure 1. Relationship of various parts of Assembler Editor cartridge 

to you and your software. 



In Section 3 we explain the Editor; in Section 4, the Assembler; and in Section 5, 
the Debugger. There are some fundamental ideas we must explain first. 
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NOTES: 
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GETTING 

STARTED 



ALLOCATING 

MEMORY 



The very first decision you must make when you sit down to write your source 
program involves the allocation of memory space. 

All programs, regardless of language, occupy memory space. The computer has 
a limited amount of memory and must manage its memory carefully, allocating 
portions of memory for program, data, display space, and so forth. This is all 
done automatically in BASIC, so the BASIC user need not worry about where in 
memory his program and data are stored. Such is not quite the case with the 
Assembler Editor cartridge. You have the power to place your programs 
anywhere in memory that you desire. With this power comes the responsibility 
to allocate memory wisely. 

The ATARI computer system uses low memory for its own internal needs. The 
amount it uses depends on whether or not DOS is loaded into RAM. In any 
event, the Assembler Editor cartridge will automatically place your source pro- 
gram into the chunk of memory starting with the first free memory location. 
As you type in more source code, the memory allocated to storing your source 
code (called the Edit Text Buffer”) grows. If you delete lines of source code, the 
edit text buffer shrinks. You can visualize the memory allocation with this 
figure, which is called a memory map: 



OS 

RAM 

h 



DOS 

RAM 



-A 
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180 Edit Text 


Empty 


Bytes Buffer , 


Memory 


H i 




-*4* 





I — C 

Display 
RAM 

Top Of 
Your RAM 



c 



Bottom of 
Usable RAM 



*not to scale 



Top of 
Addressable 
Memory 



Figure 2. Memory map without use ofLOMEN. 



The edit text buffer always grows towards the right, into the “empty memory” 
area. The left side of the edit text buffer is fixed in place once you start entering 
code. 

Your problem is to determine where to store the object code produced by the 
Assembler. If you put the object code into the regions marked OS RAM, DOS 
RAM, or display RAM, you will probably cause the computer to crash and all 
your typing will be lost. If you put it into the place called the edit text buffer, 
the object code will overwrite the source code, causing more chaos. The only 
safe place to put your object code is in the “empty memory” area. 
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You can find out where this empty memory area is by typing SIZE gg§j . 
Three hexadecimal numbers will be displayed, like so: 

SIZE £ 

0700 0880 5C1F 
EDIT 



The first number (0700 in this example) is the address of the bottom of usable 
RAM, the point labeled ‘"A” on the memory map. The second number is the 
address of the top of the edit text buffer, labeled “B” on the memory map. The 
third number is the address of the top of empty memory, labeled “C” on the 
memory map. The difference between the second and third numbers (how 
good are you at hexadecimal subtraction?) is the amount of empty memory. You 
can use the SIZE command any time you desire to know how much empty 
memory remains. 



Liberally estimate the amount of memory your object program will require, 
then subtract that amount from the third number. For extra insurance, round 
the result down. For example, if you thought that your object code might 
require 1.5K, you’d subtract 2K from $5C1F to get $541F and then for simplicity 
(and additional insurance) you would round all the way down to $5000. You 
would therefore store your object code at $5000, confident that it would not 
encroach on the display memory. More conservative estimates and greater care 
would be necessary if memory were in short supply. 



Having decided to store the object program starting at address $5000, your next 
task is to declare this to the computer. This is done with * = directive. The very 
first statement of the source code would read: 

10 *=$5000 



This directive tells the Assembler to put all subsequent object code into memory 
starting at address $5000. Although it is not absolutely necessary, it is always 
wise practice to make the * = directive the very first line of your source 
program. 



You have two other strategies for allocating memory space for your object 
program. The first and simplest strategy is to place your object code on page 6 of 
memory. The 256 locations on page 6 have been set aside for your use. If your 
object program and its data will all fit into 256 bytes, then you can put it there 
with the directive: 

10 *=$0600 



This is a good safe way to start when you are still learning assembly language 
programming and are writing only very short programs. As your programs 
grow larger, you will want to move them off page 6 and use page 6 for data and 
tables. 



The second strategy is to bump the edit text buffer (your source program) up- 
ward in memory, leaving some empty memory space below it. You can then 
place your object code into this empty space. Figure 3 shows the adjustment of 
the memory map. 
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Figure 3. Memory map with use ofLOMEM. 



This bumping is accomplished with a special command called LOMEM. The 
command is special because it must be the very first command you enter after 
turning on the computer. Its form is simple: 

LOMEM XXXX 



where XXXX is the hexadecimal address of the new bottom edge of the edit text 
buffer (point A in the memory map). You must not set LOMEM to a smaller 
value than it normally is, or you will overwrite OS data or DOS and crash the 
system. Furthermore, if you set LOMEM too high, you will have too little room 
for your source program. You must estimate how much memory your object 
code will require, and bump the edit text buffer upward by that 'much plus 
some more for insurance. Then your first program instruction becomes: 

10 * =$YYYY 



where YYYY is the old value of A given by the SIZE command before you 
turned off the computer, turned it back on, and used the LOMEM command. 

You might wonder why anybody would want to use the LOMEM command and 
store the object program in front of the source program instead of behind it. 
The primary reason this command is provided comes from the fact that the 
Assembler program, as it translates your source program into an object pro- 
gram, uses some additional memory (called a symbol table) just above the edit 
text buffer. If you really wanted to, you could figure just how much memory 
the symbol table uses; it is three bytes for each distinct label plus one byte for 
each character in each label. Most programmers who don’t enjoy figuring out 
how big this symbol table is use the LOMEM command so they won’t have to 
worry about it. (Only the label itself counts, not the number of times it appears 
in the program.) 

Allocating memory can be a confusing task for the beginner. Only two instruc- 
tions (LOMEM and *=) are used, but if they are misused you can crash the 
system and lose your work. Fortunately, if you restrict yourself to small pro- 
grams initially you’ll have plenty of empty memory space and fewer allocation 
problems. 

The * = directive will be followed by your source program. The source program 
is composed of statements. The statements must be written according to a 
rigorous format. The rules for writing statements are given in the next section. 
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PROGRAM 
FORMAT— HOW 
TO WRITE A 
STATEMENT 



A source program consists of statements. Each statement is terminated with 
HCflllll- -A statement may be 1-106 characters long, or almost three lines on the 
screen. A statement is also called a line. The distinction is made between a 
physical line (a line on the screen) and a logical line (the string of characters, up 
to three physical lines between 8TCTi!gl s). 



A statement can have up to five parts or “fields”: the statement number, a label, 
the operation code mnemonic or directive, an operand, and a comment. These 
five fields occupy successive positions in the statement, with the statement 
number coming first and the comment coming last. Fields are separated 
(“delimited”) by single spaces. 



Statement Number 

Every statement must start with a number from 0 to 65535. It is customary to 
number statements in increments of 10, 20, 30, etc. The Editor automatically 
puts the statements in numerical order for you. Numbering by tens allows you 
to insert new statements at a later date between existing statements. To assist 
you, the Editor has several convenient commands for automatically numbering 
statements (see NUM, REN). 



Label 

A label, if used, occupies the second field in the statement. You must leave 
exactly one space (not a tab) after the statement number. The label must start 
with a letter and contain only letters and numbers. It can be as short as one 
character and as long as the limitation of statement length permits (106 less the 
number of characters in the statement number). Most programmers use labels 
three to six characters long. 

You are not forced to have a label. To go on to the next field, enter another space 
(or a tab). The Assembler will interpret the entries after a tah as an operation 
code mnemonic. 



Operation Code Mnemonic 

The operation code (or op code) mnemonic must be one of those given in 
Appendix 2. It must be entered in the field that starts at least two spaces after 
the statement number, or one space after a label. An operation code mnemonic 
in the wrong field will not be identified as an error in the Edit mode, but will be 
flagged when you assemble the program (Error 6). 



Operand 

The field of the operand starts at least one space (or a tab) after an operation code 
mnemonic. Some operation code mnemonics do not require an operand. The 
Assembler will expect an operand if the op code mnemonic requires one. Each 
different way of writing an operand is given in the section called HOW TO 
WRITE OPERANDS. 



Comment 

A comment appears on the listing of a program, but does not in any way affect 
the assembled object code. Programmers use comments to explain to others (and 
to themselves) how a section of code works. 
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There are two ways to have the Assembler interpret entries as comments. One 
way is to make the entries in the comment field, which occupies the remainder 
of the line after the instruction field(s). At least one space must separate the 
instruction fields from the comment field. There may not be enough space in 
the comment field for the comment you wish to write there. In that case it is 
best to use one or more lines as comment lines dedicated only to making com- 
ments and containing no code. To do so, you enter one space and a semicolon 
followed by any comment or explanatory markings you desire. Everything 
between the initial semicolon and the |g |§| is ignored by the Assembler, but 
will be printed in the listing of the program. 



A sample programming form for assembly language is reproduced as Figure 4. 
The form shows examples of how to enter line number, label, op code, operand 
and comments. These classes of entry are lined up vertically on the program- 
ming form. Most variation occurs in the method of entering a comment. 
Therefore, Figure 4 includes examples of the various ways to enter comments. 



Sample, Reproducible 
ATARI Programming Form 
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Figure 4. Example of how to yvrite Line No., Label, Op Code, Operand, 
and Label on the Atari programming form. 
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The spacing on the programming form is not the same as the spacing to be used 
on the screen, controlled by keyboard entry. On the screen the classes of entry 
(the fields) are not lined up vertically. The screen has 38 positions (you can 
change it to a maximum of 40), fewer than the programming form, and that is 
the main reason not to use many spaces between fields. Another difference be- 
tween the programming form and screen is the ‘wraparound’ on the 
screen— automatic continuation of characters onto the next line. 

Figure 5 shows the entries in Figure 4 as they should appear on the screen when 
entered on the keyboard with the recommended spacing. In general, the spac- 
ing recommended in this manual is the minimum spacing that will be correctly 
interpreted by the Assembler Editor. If you prefer to have more vertical align- 
ment of fields, use TAB, rather than the single spacing between fields that we 
recommend. The statements below show various examples of comments cor- 
rectly positioned in the statement. Each comment in the examples starts with 
“COMMENT” or semicolon(;). 




Figure 5. Statements as they would appear on the screen when entered 
on the keyboard with the recommended spacing. The various 
ways to enter comments are illustrated. Compare with Figure 4. 



HOW TO WRITE This section shows how to write operands. The examples use statement number 
OPERANDS xxxx (also called line number XXXX). An instruction entered without a state- 

ment number is not allowed by the Editor. 

The examples use BY (for byte) and ABS (for absolute) as a one-byte and a two- 
byte number, respectively. This use implies that the program includes defini- 
tions of BY and ABS as, for example: 

0100 BY = 155 
0200 ABS = 567 

Please refer to the description of the LABE = directive for an explanation of the 
definitions of lines 100 and 200. 



Hexadecimal Operands 

A number is interpreted as a decimal number unless it is preceded by $, in 
which case it is interpreted as a hexadecimal number. 

Examples: 

30 STA $9325 
80 ASL $15 

Immediate Operands 

An immediate operand is an operand that contains the data of the instruction. 
The pound sign (#) must be present to indicate an immediate operand. 

Examples: 

40 LDA #12 
70 ORA #$3C 
1000 CPY #BY 

Page Zero Operands 

When an operand is a number less than 255 decimal, (FF hex) and is not 
immediate, the number is interpreted as a page zero address. 



Examples: 

150 LDX $12 
250 ROR 33 
500 DEC BY 

Absolute Operands 

Absolute operands are evaluated as 16-bit numbers. 



Examples: 

20 LDX $1212 
40 CPY 2345 
990 DEC 579 
2350 BIT ABS 



Absolute Indexed Operands 

An absolute indexed operand uses register X or Y. The operand is written 
,X or ,Y 
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Examples: 

10 AND $3C26,X 
110 EOR 20955, Y 
1110 STA ABS,Y 

Non-Indexed Indirect Operands 

In general, an indirect operand is written with parentheses. The address within 
the parentheses is an intermediate address which itself contains the effective 
address. The only instruction with a non-indexed indirect operand is Jump In- 
direct. The operand is a number enclosed in parentheses. The parentheses in the 
operand enclose a number or an expression that is interpreted as an inter- 
mediate address. 

Examples: 

JMP ($6000) 

JMP (ABS) 

JMP (7430) 

JMP (ABS + 256* BY) 

Indexed Indirect Operands 

An indexed indirect instruction uses register X. The operand is written (— ,X) 
Examples: 

10 INC ($99, X) 

Indirect Indexed Operands 

An indirect indexed instruction uses register Y. The operand is written (— ),Y 

Examples: 

10 LDA ($2B),Y 
110 CMP ($E5),Y 
1110 ORA (BY),Y 

Indexed Page Zero Operands 

A zero page indexed operand is written — ,X or — ,Y 

Examples: 

10 INC $34, X 
110 STX $AB,Y 
1110 LDX BY,Y 

String Operands 

Operands or parts of operands enclosed in double quotation marks are 
translated into the ATASCII codes of the characters between the quotation 
marks. The use of such operands must of course be appropriate to the type of 
instruction or directive to which they are appended. 

Examples: 

10 ADDR .BYTE “9 + 1 =s TEN” 

Execution of this directive causes the ATASCII numbers corresponding to “9”, 
“ + ”, etc., to be stored at successive locations starting at ADDR. Note that the 
ATASCII representation of any character except the quotation mark (”) can be 
stored with the .BYTE directive having a string operand. 



Exhibit I 



Sample, Reproducible 
ATARI Programming Form 
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COMMANDS TO 
EDIT A 
PROGRAM 



USING 
THE EDITOR 



Now that we have explained how to get started writing a program, it is up to 
you to actually write the program. This manual contains very little information 
on assembly language programming techniques. We assume that you are 
already familiar with assembly language. The remainder of the section 
describes how to use the Assembler Editor cartridge. 



A command is not the same thing as an instruction. An instruction has a line 
number; a command has no line number and is executed immediately. 



NEW Command 

This command clears the edit text buffer. After this command you cannot 
restore your source program; it has been destroyed. 



Some programmers have the habit of giving the NEW command (or its 
equivalent with other assemblers) when they start a programming session. The 
reason is to remove any “garbage” that may be in memory by mistake. Since 
the ATARI Personal Computer System clears its memory when it is turned on, 
such routine use of NEW would be a needless precaution. Because NEW destroys 
your entire source program, it is more important to develop a habit of NOT 
using it routinely. You should, rather, use NEW in a very deliberate fashion only 
when you want to remove a source program from RAM. 

DEL Command 

This command deletes statements from your source program. 



DELxx 

DELxx,yy 



RETURN 






deletes statement number xx. 

deletes statement numbers xx through yy. 



NUM Command 

This command assigns statement numbers automatically. 



NUM 




increments statement number by 10 
after each gg§g|jg|. The new statement 
number, followed by a space, is auto- 
matically displayed. 


NUMnn 


era 


has the same effect as NUM, but the 
increment is nn instead of 10. 


NUMmm,nn 




forces the next statement number to be 
mm and the increment to be nn. 


SSSEBB 


m m 


cancels the NUM command. 
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The effect of the NUM command stops automatically when a statement number 
that already exists is reached. For example: 

10 LDX #$EF 
20 CMP MEMORY 
NUM 15,5 
15 

After statement number 15, the next statement number would be 20, which 
already exists, so the NUM command is cancelled. The automatic numbering of 
statements will continue until the next number is exactly ecjual to an existing 
number. A slight change from the above example illustrates this: 

10 LDX #$EF 

20 CMP MEMORY 
NUM 15,6 

15 TAX 

21 

Caution: You cannot use the special keyboard editing keys to change other 
statements while the NUM command is in effect. You will succeed in changing 
what appears on the screen, but, in an exception to the general rule, the con- 
tents of the edit text buffer will not be changed. 

REN Command 

This command renumbers statements in your source program. 

REN renumbers all the statements in 

increments of 10, starting with 10. 

RENnn renumbers all the statements in 

increments of nil, starting with 10. 

RENmm nn renumbers all the statements in 

increments of nn, starting with mm. 

FIND Command 

This command finds a specified string. The ways to write the command are 
shown below. 

FIND/SOUGHT/ « finds the first occurrence of the string 

SOUGHT. The statement that contains 
the string is displayed. 

FIND/SOUGHT/, A EB finds all occurrences of the string 

SOUGHT. All statements containing such 
occurrences are displayed. 

FIND/SOUGHT/xx 1113 finds the string SOUGHT if it occurs in 

statement number xx. Statement xx is 
displayed if it contains the string. 

FIND/SOUGHT/xx, yy, A finds all occurrences of the string 

SOUGHT between statement number xx 
and yy. All the statements that contain 
the string are displayed. 
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In these examples, the string SOUGHT is delimited (marked oft) by the 
character /. Actually, any character except space, tab and ffiSSsSI can be used as 
the delimiter. For example, the command 

FIND DAD 

finds the first occurrence of the character A. The delimiter is the character D. 
The delimiter is defined as the first character (not counting space or tab) after 
the keyword FIND. This feature is perplexing to beginners; its purpose is to 
allow you to search for strings that contain slashes 00 or, for that matter, any 
special characters. 

The general form of the command is 

FIND delimiter string delimiter [lineno, lineno] [,A] 

In the general form, symbols within a pair of brackets are optional qualifiers of 
the command. 



REP Command 

This command replaces a specified string in your source program with a dif- 
ferent specified string. 

REP/OLD/NEW replaces the first occurrence of the string 

OLD with the string NEW. 

REP/OLD/NEW/xx,yy replaces the first occurrence of the string 

OLD between statements number xx to 
yy with the string NEW. 

REP/OLD/NEW/, A replaces all the occurrences of the string 

OLD with the string NEW. 

REP/OLD/NEW/xx,yy,A replaces all the occurrences of the string 

OLD between statements xx to yy with 
the string NEW. 

REP/OLD/NEW/xx,yy,Q. displays, in turn, each occurrence of the 

string OLD between statements xx and 

yy- 

Q, stands for “query.” To replace the 
displayed OLD with NEW, type Y, then 
To retain the displayed OLD, 
press fasasgi . 

In these examples, the strings OLD and NEW are delimited by the character 
As with the FIND command, any character except space, tab and RETURN, can 
be used as the delimiter. For example, the command 

REP + RTS + BRK + ,A 

replaces all occurrences of RTS with BRK. The delimiter is the character “ + ”. 



The general form of this command is 

REP delimiter OLD delimiter NEW delimiter [lineno, lineno] L,A J 

In the general form, symbols within a pair of brackets are optional qualifiers of 
the command and the symbols within braces (A and Q) are alternatives. 
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Sample Program 

Let us assume you have written a program on an ATARI Programming Form as 
shown in Figure 6: 

Exhibit I Sample, Reproducible 

ATARI Programming Form 



-sans-. ASM 


““ l " 1 r* l^]3llfS0 




-Do& 



LINE NO. 


LABEL 


OP 

CODE 


OPERAND 


COMMENT 


10 






*•3000 








utxj 








xtr 


LPX 


atwjc. U 










*ea ' 


■smi t tee 










'ftujJ 






_ 1 
Tkp 


•zer 










■bmU 






y-m 


- 


•*+ -iloo 




— 




■6JP 






















































— 


















— 












































































































— 







































Figure 6. Sample Program as you write it on the 
A TAR1 programming form 



Then when you type it in it would appear on the screen as shown in Figure 7 




Figure 7. Appearance of the screen as your program is 
entered on the keyboard. 




COMMANDS TO 
SAVE (OR 
DISPLAY) AND 
RETRIEVE 
PROGRAMS 



The commands to save (or display) and retrieve programs are: 



LIST saves or displays a source program 
PRINT is the same as LIST, but omits line numbers 
ENTER retrieves a source program 
SAVE saves an object program 
LOAD retrieves an object program 

With each of these commands there is a parameter that specifies the device that 
is the source or destination of the program that is to be saved, displayed or 
retrieved. The possible devices are different for different commands, and the 
default device is also different. Some of the commands have optional parameters 
that limit the application of the command to specified parts of the program. 

The parameter that specifies the device that is the source or destination of the 
program is written as follows: 



#E: 



is the screen editor 



ttV 



is the printer 



ffC: 

#D[n]:FILENAME 



is the Program Recorder 
is a disk drive. 

n is 1, 2, 3 or 4. D: is interpreted as Dl:. 

A program saved on or retrieved from a diskette must be 
named (FILENAME). 



LIST Command 



Format: 

Examples: 



LIST# 



device: 

filespec 



[,xx,yy] 



LIST#E: 



LIST#D:MYFILE 



This command is used to display or save a source program. The device where 
the source program is to be displayed or saved is given in the command. If no 
device is specified, the screen is assumed by default. Other possible devices are 
the printer (#P:), Program Recorder (#C:) and disk drive (#D1: through #D8: or 
#D:, which defaults to #D1:). The commands to transfer a program (LIST it) to 
these various devices are: 



LIST#E: (LIST#E: is the same as LIST) 

LIST#P: 

LIST#C: (Use cassette-handling procedures described in your Pro- 

gram Recorder Operator’s Manual.) 

LIST#D:filename where filename is an arbitrary name you give to the 

program. Filename must start with a letter and have no 
more than eight characters, consisting of letters and 
numbers only. It may also have an extension of up to 
three characters. For example, NAME3, ST5, and 
JOHN.23 are all legal names. 
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The forms of the commands to transfer only particular lines (lines xx to yy) to a 
device are: 

LIST#E:,xx,yy (LIST#E:,xx,yy is the same as LIST,xx,yy) 

LIST#P:,xx,yy 

LIST#C:,xx,yy (Use cassette-handling procedures described in the 

Program Recorder Operator’s Manual.) 
LIST#D:NAME,xx,yy where “NAME” is an arbitrary name you give to the 
program. See the description above. 

A single line may be displayed or saved with the command: 

LISTlineno where lineno is the line number. 



Caution: The DOS makes sure that every file has a unique name by deleting old 
files if necessary. Therefore, do not name a file you are listing to diskette with 
the name of a file that is already stored on the diskette, unless you wish to 
replace the existing file with the one you are listing. 



The LIST command is illustrated below. No device is specified, so the display 
device is the screen, by default. The small sample program, written in the 
previous section, is used for illustration. 



EDIT 



LIST Em 



10 

20 

30 

40 

50 

GO 

70 

80 

90 



*=$3000 
LDY #00 

REP LDX, ABSX, Y 
BNE XEQ SAME PAGE 
INY TALLY 



JMP REP 
ABSX = $3744 
XEQ, = *+$60 
.END 



EDIT 

LIST30 



return; 



30 REP LDX ABSX, Y 
EDIT 

LIST 60,80 lima 



60 JMP REP 
70 ABSX = $3744 
80 XEQ=*+$60 

EDIT 

□ 



The examples above show the appearance of the screen, since that is the default 
device. The program or the particular lines in the examples could be displayed 
on the printer or saved on cassette or diskette by using the forms of the LIST 
command described above. Note that the commands tolerate a certain amount 
of variation in the insertion of blanks. 
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PRINT Command 



This command is the same as LIST, except that it prints statements without 
statement numbers. 



Example: 

EDIT 



RETURN 



*=$3000 

ldy #oo 

REP LDX ABSX, Y 

BNE XEQ SAME PAGE 

INY TALLY 

JMP REP 

ABSX = $3744 

XEQ=*+$60 

.END 



EDIT 

PRINT30 



RETURN 



REP LDX ABSX, Y 



RETURN 



EDIT 

PRINT 60,80 BBfflam 

JMP REP 
ABSX = $3744 
XEQ,= *+$60 



return 



EDIT 

D 



After using a PRINT 
press iittfliiTCl . which 



command, no further command can be entered until 
causes the EDIT message and cursor to be displayed. 



you 



ENTER Command 



Format: 



ENTER# 



device: 

filespec 



Examples: ENTER#C: 

ENTER#D:MYFILE 



The command ENTER is used to retrieve a source program. As with the com- 
mand LIST, a device has to be specified, in this case the device where the pi'o- 
gram is stored. There is only one device, the disk drive, on which a named pro- 
gi am is stored in a retrievable form. To retrieve a source program from a 
diskette in a disk drive, the command is: 

ENTER#D:NAME 
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where “NAME” is the arbitrary name you gave to the program when you listed 
it on the diskette. This command clears the edit text buffer before transferring 
data from the diskette. 

To retrieve a source program from cassette, the command is: 

ENTERIC: (Follow the CLOAD procedure given in your 410 Pro- 

gram Recorder Operator’s Manual.) Note that ENTER #C: 
clears the edit textbuffer before retrieving the 
source program. 

To merge a source program on cassette with the source program in the edit text 
buffer, the command is: 

ENTERIC:, M 

In the above command, where a statement number is used twice (in the edit text 
buffer and on tape), the statement on cassette prevails. 

Commands for saving and retrieving an object program are SAVE and LOAD. 
They correspond to LIST and ENTER, respectively. 



SAVE Command 

Format: SAVE# ^Uespec^j < addressi, address 

Examples: SAVE#C: < 1235,1736 

SAVE#D2:MYFILE< 1235,1736 






To save an object program residing in hex addressl to address2 on cassette 
or diskette, the commands are: 

SAVE#C: < addressl, address2 

CAUTION: Use the CSAVE procedure illustrated in your 410 Program 
Recorder Operator’s Manual. 



SAVE#D:FILENAME < addressl, address2 

where FILENAME is an arbitrary name you give to the block of 
memory that you are saving (where your object program is 
stored). 



LOAD Command 



device: 

Format: LOAD# 

filespec 

Examples: LOAD#C: 

LOAD#D:MYFILE 
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To retrieve an object program that had previously been SAVED and which had 
previously been called NAME, the command is: 

LOAD#D:NAME where NAME is the arbitrary name that you gave to the 
object program when you saved it on diskette. 

LOAD#C: (Use the CLOAD procedure described in your 410 Pro- 

gram Recorder Operator’s Manual.) 

These commands will reload the memory locations addressl to address2 with 
the contents that were previously saved. The numbers addressl and address2 
are those that were given in the original SAVE command. 






W 
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USING 
THE ASSEMBLER 



THE ASM 
COMMAND 



The general form of the ASSEMBLE command is 



| ASM#[#D[n]:PROGNAME[.SRC]] | 



M#P:l 

|L,S#D[nl:LISTING[.LST]iJ | 



| [,#D[nl:SEMBLED[.OBJ]l | 



Where source program 
is located 



Where object program 
is to be stored 



Where assembly listing 
is to be stored or displayed 



The default values of the three parameters of the ASM command are the edit 
text buffer for the source program, the television screen for the assembly 
listing, and computer RAM for the object program (the assembled program). To 
assemble a program using default values of ASM, type 



RETURN 



On receiving this command, the Assembler translates the source program in the 
edit text buffer into object code and writes the object code into the memory loca- 
tions specified in the source program. When this process is completed, the 
assembled program is displayed on the screen. For an example of assembly with 
default parameter values, we use the small sample program that we wrote. 
Figure 8 shows the appearance of the screen after the ASM command. 




Figure 8. Appearance of the screen as your sample program is 

assembled. 
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Using; statements 30 and 40 as examples, the format of the assembled program is 
shown below. Note, however, that some of the spacing can be changed by the 
TAB directive. 



3002 



BE4437 30 REP LDX ABSX, Y 




Operand 

Op Code Mnemonic 
Label 

Statement Number 
Instruction 

Comment from previous 
line starts here 
Address 



Figure 9. Normal (default) format of assembly listing as it appears 

on the screen. 



The general form of the command shown at the beginning of the section shows 
how to override the default values of the parameters of the command. Ihese 
override selections are explained below. 



Location of Source Program 

You may specify the location of the source program as a named program on 
diskette. You must have previously stored the source program under that name, 
using; the LIST command. In the general form of the ASM command, the source 
program on diskette has been given the extension .SRC. Extensions are optional. 

Where Assembly Listing Is To Be Stored 

The default value is the screen (#E:). The other possibilities are the printei (#P.), 
the Program Recorder (#C:), and the disk drive (#Dtn]:NAME [.LST]). 



Where Object Program Is To Be Stored 

You may specify that the assembled program is to be stored directly on diskette, 
using any name (subject to the restrictions of DOS). In the general form of t i 
ASM command, the assembled program has been given the extension .OBJ. 
Extensions are optional. 

It is easy to become confused by names of programs when a program may exist 
in several related forms. To reduce the chance of confusion, we recommend 
using names that include identifying extensions, such as .SRC, .LST and .OBJ tor 
a source program, an assembly listing and an object program, respectively. 



Note that in the ASM command the source program must be in the edit text buf- 
fer or on a diskette in the disk drive. It can not be on a cassette in the Progiam 
Recorder. The primary reason for this restriction is that the Assembler requires 
two passes of the source program and the Program Recorder is not controllable 
to permit two passes. However, you can assemble a source program i ecorded 



with your Program Recorder. First transfer the program from Program 
Recorder to the edit text buffer with the command: 

ENTERIC: (Follow the cassette-handling 

instructions in your Program 
Recorder Operator’s Manual.) 

The ASM command with no default parameters is illustrated in the example 
below: 

ASM#D:SOURCE,#P:,#D2:SEMBLED.OBJ SIB 



The above command takes the source program that you had previously stored 
on diskette and called SOURCE, assembles it, lists the assembled form on the 
printer, and records on the diskette the machine code translation of the pro- 
gram (the object program). The object program is given the name 
“SEMBLED.OBJ.” Note that commands of this form store the machine code on 
diskette, not in computer RAM. 

To make a default selection, enter a comma, as in the following useful 
command: 

asm,#p : 

The above command takes the source program from the default edit text buffer, 
assembles and lists it on the printer as before, and stores the machine code 
object program directly into computer RAM. 



DIRECTIVES 

(PSEUDO 

OPERATIONS) 



Directives are instructions to the Assembler. Directives do not, in general, pro- 
duce any assembled code, but they affect the way the Assembler assembles 
other instructions during the assembly process. Directives are also called pseudo 
operations or pseudo ops. 



Directives are identified by the Assembler by the at the beginning. The only 
exceptions are the LABEL = directive and the * = directive. 



A directive must have a line number, which it follows by at least two spaces. 
The directive LABEL = is an exception— there must be only one space before the 
label. 



OPT Directive 

This directive specifies an option. There are four sets of options. These are: 



OPT NOLIST 




OPT LIST 


(this is the default condition) 


OPT NOOBJ 




OPT OBJ 


(this is the default condition) 


OPT NOERR 




OPT ERR 


(this is the default condition) 


OPT NOEJECT 




OPT IJECT 


(this is the default condition) 
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The second listed of each pair represents the standard or default condition. 



100 . OPT NOLIST The effect of these directives is to omit from the listed 
(part of source form of the assembled program the lines between lines 
program) 100 and 200. (These line numbers are arbitrary.) 

200 . OPT LIST 



100 . OPT NOOOBJ 
(part of source 
program) 

200\ OPT OBJ 



Assembly is suppressed between lines 100 and 200. The 
effect of these directives is to omit from the object pro- 
gram code corresponding to the lines between lines 100 
and 200. Memory corresponding to these lines is skipped 
over, leaving a region of untouched bytes in the object 
program. (These line numbers are arbitrary.) 



100 . OPT NOERR The effect of these directives is to omit error messages 
(part of source for the assembled program lines between lines 100 
program) and 200. 

200 . OPT ERR 



100 . OPT NOEJECT The effect of these directives is to suppress, between 
(part of source lines 100 and 200, the 4-line page spacing that is 
program) normally inserted after every 56 lines of the listed form 

200 . OPT EJECT of the assembled program. 



More than one option may appear on a line. Options are then separated by a 
comma, as follows: 

1000 . OPT NOLIST, NOOBJ 



Title and Page Directives 

10 . TITLE “name” 

20 . PAGE “optional message” 

We explain these directives together because they are intended to be used 
together to provide easily read information about the assembled program. 

These directives are most useful when the assembled program is listed on the 
printer. 

TITLE and PAGE allow you to divide your program listing into segments that 
bear messages written for your own convenience, much as you might add short 
explanatory notes to any complex material. 

The PAGE directive causes the printer to put out six blank lines (printers so 
equipped will execute a TOP OF FORM), followed by the messages you have 
given for TITLE and PAGE. This causes the messages to stand out somewhat 
from the rest of the assembled program listing. 

Usually there is only one TITLE directive, giving the program name and date, 
and different PAGE directives for giving different page messages. Then on 
listing the assembled program, the same TITLE message on every page would 
be followed by a different PAGE message. 

The blank lines that the PAGE directive produces on the 40-column ATARI 820 
Printer can be used to break up a long program into segments that can be 
mounted in a notebook. 




To remove a title, use the following form: 

1000 . TITLE “ ” 

The above directive removes titles after line 1000. 

The PAGE directive on its own causes a page break— the printer simply puts out 
a number of blank lines. 

Tab Directive 

10 . TAB nl,n2,n3 

The TAB directive sets the fields of the statement as they appear when assem- 
bled and listed on the screen or the printer. Let us use the specific example of 
Statement 40 of the small sample program we previously used for illustration. It 
was written as follows: 

30 ... 

40 BEQ XEQ SAME PAGE 
50 ... 

Note that one space, rather than a tab, is used between each field. Using spaces 
rather than tabs lets you write longer programs, since the edit text buffer will 
not be filled up with the extra spaces that tabs would require. 

Compressing the program in this way makes it less easily readable than we 
might wish, but we can use the TAB directive to give us a more readable 
assembled version. The form of the directive is 

lineno . TAB 10,15,20 
or, more generally, 

lineno . TAB number I,number2,number3 

The previous example has a source program that was compressed in the above 
fashion. Note the difference between the spacing of the source listing and the 
assembled program. This is an example of the default TAB spacing. 

The effect of the TAB directive of line xxx is confined to the appearance of lines 
following xxx when they are assembled and listed on the printer or screen. 

In the case of line 40, the appearance on the printer would be as shown below: 

3005 D0G4 40 BNE XEQ SAME PAGE 

-10-1 I 

15—1 

20 — 

If the TAB directive is not used, then the appearance of the assembler line on the 
printer will be as shown below in the default mode: 

3005 D064 40 BNE XEQ, S 

AME PAGE 




27 — 1 

That is, the default setting corresponds to . TAB 12,17,27. 
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The appearance of this line on the screen will be different only because the 
screen has 38 characters positions, while the printer has 40. 

BYTE, DBYTE and WORD Directives 

100 . BYTE a,b,... ,n 
200 . BYTE “A,B,... N” 

300 . DBYTE a,b,... ,n 
400 .WORD a,b,... ,n 

These directives are similar in that they are used to insert data rather than 
instructions into the proper places in the program. Each directive is slightly 
different in the manner in which it inserts data. 

BYTE Directive 

The BYTE directive reserves a location (at least one) in memory. The directive 
increments the program counter to leave space in memory to be filled by infor- 
mation required by the program. The operand supplies the data to go into that 
space. 

Examples: 

10 

20 . BYTE 34 
30 

Here, the Assembler assembles into successive locations the instruction of line 
10, then the decimal number 34, then the instruction of line 30. 

10 

20 . BYTE 34, 56,78 
30 

Here, the Assembler assembles into successive locations the instruction of line 
10, then the decimal numbers 34, 56 and 78, then the instruction of line 30. The 
operand may be an expression more complex than the numbers used in the 
examples. The rules for writing and evaluating an expression are given in 
Appendix D. 

10 

20 . BYTE “ATARI” 

30 

Here, the Assembler assembles into successive locations the instruction of line 
10, then the (ATASCII code) hex numbers 41, 54, 41, 52 and 49, then the instruc- 
tion of line 30. 

DBYTE Directive 

The DBYTE directive reserves two locations for each expression in the operand. 
The value of the expression is assembled with the high-order byte first (in the 
lower number location). For example: 

10 * = S4000 

20 .DBYTE ABS + $3000 



When line 20 is assembled and the value of ABS + $3000 is determined to be (say) 
$5123, $51 is put in location S4000 and $23 is put in location $4001. 



WORD Directive 



The WORD directive is the same as the DBYTE directive except that the value of 
the expression is stored with the low-order byte first. 

For example: 

10 *=$4000 

20 .WORD ABS + S3000 

When line 20 is assembled and the value of ABS + $3000 is determined, as before, 
to be $5123, $23 is put in location $4000 and $51 is put in location $4001. 



The WORD directive simplifies some programming since addresses in machine 
code are always given in the order low byte followed by high byte. Therefore, 
the WORD directive is useful, for example, in constructing a table of addresses. 

100 LABEL = expression 

The LABEL = directive is used to give a value to a label. Two examples appear in 
the sample program we used before. Statements 60 and 70 give values to ABSX 
and XEQ, as follows: 

60 ABSX = $3744 
70 XEQ= * +$60 

Since the symbol that is given a value is a label, there must be only one space 
after the statement number. The expression on the right cannot have a value 
greater than FFFF (hex). The rules for writing and evaluating an expression are 
given in Appendix 4. 

When the LABEL = directive is used to give a value to a label, the label can be 
used in an operand, by itself, as in statements 30 and 40 in the sample program. 

A defined label may also appear as part of an expression. Our sample program 
does not contain an example, so we give one below in line 240. 

100 TAB1 = $3000 



240 TAB2 = TAB1 +$20 

When the program is assembled, TAB2.will be given the value $3020. 

You should note that defining a label in this way gives the label a specific 
address; it does not define the contents of the address. In the example, above, 
TAB1 and TAB2 might be the location of two tables that contained the values of 
variables that your program required. 

* = Directive 

100 * = expression 

We encountered the * = directive in the “getting started” commands, where it 
is used to set the starting location of the assembled program. When the 
Assembler encounters the * = expression, it sets the program counter to the 
value of the expression. 
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You write *= without the initial that the other directives have (except 
LABEL = ). Also, note that you write *= without any spaces between * and =. 

You should not confuse the * = directive with the LABEL = directive. The * in 
* = is not a label. Note, however, that the * = directive itself may have a label, as 
follows: 

200 GO * = expression 
500 JMP GO 

The Assembler will assemble statement 500 as a jump to the value the program 
counter had BEFORE it was changed by line 200. 

The * = directive is useful for setting aside space needed by your program. For 
example, you will frequently want space reserved starting at a particular loca- 
tion. Use the following form: 

720 TABLE35 * = *+$24 
740 ... 

The effect of the directive is to reserve 24 locations immediately after TABLE35. 
Other parts of your code will not be assembled into these locations (unless you 
take pains to do so). Your program can use TABLE35 as an operand and 
TABLE35 can be used as an element in an expression that your instructions 
evaluate in accessing the table. 

IF Directive 

900. IF expression ©LABEL 



990 LABEL End of conditional assembly 

The IF directive permits conditional assembly of blocks of code. In the illustra- 
tion above, all the code between lines 900 and 990 will be assembled if and only 
if the expression is equal to zero. If the expression is not equal to zero, the IF 
directive has no effect on assembly. 

The example given below shows how different parts of a source program may 
be omitted from assembly according to the value assigned to the LABEL in the IF 
directive. The source program is assembled with Z = 0 in one case and Z = 1 in 
another. With Z = 0, the instruction TAX is assembled, and with Z = 1 the in- 
struction ASL A is assembled. Obviously, this kind of selective assembly can be 
extended indefinitely. 



SOURCE CODE 

0100 ;CONDITIONAL ASSEMBLY EXAMPLE 

0120 Z = 0 

0130 *=$5000 

0140 LDA = $45 

0150 . IF Z@ZNOTEQUAL0 

01G0 TAX ;THIS CODE ASSEMBLED IFF Z = 0 

0170 ZNOTEQUALO 

0180 . IF Z - l@ZNOTEQUALl 

0190 ASL A ;THIS CODE ASSEMBLED IFF Z = 1 

0200 ZNOTEQUAL1 

0210 INX ;THIS CODE ALWAYS ASSEMBLED 



ASSEMBLY LISTING (40-col. format) 

0100 CONDITIONAL ASSEMBLY E 
XAMPLE 

0000 0120 Z = 0 

0000 0130 * = $5000 
5000 A945 0140 LDA #$45 
5002 0150 . IF Z@ZNOTEQUA 
L0 

5002 AA 0160 TAX ; 

THIS CODE ASSEMBLED IFF Z = 0 
0170 ZNOTEQUALO 

5003 0180 .IF Z - l@ZNOTEQ 
UAL1 

0190 ASLA 
0200 ZNOTEQUAL1 
5003 E8 0210 INX ; 

THIS CODE ALWAYS ASSEMBLED 

0100 CONDITIONAL ASSEMBLY E 
XAMPLE 

0001 0120 Z = 1 
0000 0130 *= $5000 
5000 A 945 0140 LDA #$45 
5002 0150 . IF Z@ZNOTEQUA 
L0 

0160 TAX ;THIS CODE ASSEMBL 
ED IFF Z = 0 

0170 ZNOTEQUALO 
5002 0180 .IF Z-l@ZNOTEQ 
UAL1 

5002 OA 0190 ASL A 
0200 ZNOTEQUAL1 

5003 E8 0210 INX ; 

THIS CODE ALWAYS ASSEMBLED 

END Directive 

1000 . END 

Every program should have one and only one END directive. It tells the 
Assembler to stop assembling. It should come at the very end of your source 
program. Later, if you decide to add more statements to your program, you 
should remove the old . END directive and place a new one at the new end of 
your source program. Failure to do so will result in your added source code not 
being assembled. This mistake is particularly easy to make when vou make 
your additions with the NUM command. It is not always essential to have an 
. END directive, but it is good practice. 
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PURPOSE OF 
DEBUGGER 



CALLING THE 
DEBUGGER 



DEBUG 

COMMANDS 



DEBUGGING 



I he Debugger allows you to follow the operation of an object program in detail 
and to make minor changes in it. 

A knowledge of machine language is helpful when you use the debugger, but it 
is not essential. The Debugger is able to convert machine code into assembly 
language (disassemble), so you can make code alterations at particular memory 
locations. All numbers used by the Debugger, both in input and output, are hex- 
adecimal. 

The Debugger is called from the Editor by typing: 

BUG BBBEWI 

This produces on the screen: 

DEBUG 

[] 

The command to return to the Writer/Editor is: 



RETURN 



The debug commands are listed below. In the list, “mmmm” indicates that the 
form of the command may include memory address(es). The actual methods of 
specifying the memory address(es) and the default addresses are shown in the 
examples given later in this section. If you use the commands with no 
address (es), the Debugger assigns a default address (es): 



DR 

CR 

D or Dmmmm 

C or Cmmmm 
Mmmmm 
Vmmmm 



Display Registers 

Change Registers 

Display Memory 

Change Memory 
Move Memory 
Verify Memory 



L or Lmmmm 
A 

Tmmmm 



List Memory With Disassembly 

Assemble One Instruction Into Memory 
Trace Operation 



S or Smmmm 
Gmmmm 



Single-Step Operation 
Go (Execute Program) 



X 



Return to EDITOR 



Pressing the 



BREAK 



key halts certain operations. 
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We now give several examples showing how to use the commands. In the 
examples, the lines ending with Ml are entered on the keyboard. The other 
lines show the response of the system, as displayed on the screen. 

DR Display Registers 
Example: 

EDIT 

bug mm 

DEBUG 



mwm 



A = BA X = 12 Y = 34 P = BO S = DF 
DEBUG 
[] 

The registers and contents are displayed as shown. A is the Accumulator, X and 
Y are the Index Registers, P is the Processor Status Register, and S is the Stack 
Pointer. 



CR Change Registers 
Example: 



EDIT 

BUG 



RETURN 



DEBUG 
CR< 1,2, 3, 4, 5 

DEBUG 

[] 

The effect of the command above is to set the contents of the registers A, X, Y, P, 
and S to 1, 2, 3, 4 and 5. 

You can skip registers by using commas after the <. For example, 



RETURN 



sets the Stack Pointer to E2 and leaves the other registers unchanged. Registers 
are changed in order up to §|§||ggg. For example, 

cr< ,34 mmmm 

sets the X Register to 34 and leaves the other registers unchanged. 

D or Dmmmm Display Memory 

Dmmmm, yyyy where yyyy is less than or equal to mmmm shows the contents 
of address mmmm. 

Example: 

DEBUG 

D5000,0 



5000 A9 
DEBUG 
[] 



This shows that address 5000 contains the number A9. 

If the second address (y yyy) is omitted, the contents of eight successive locations 
are shown. The process can be continued by typing D t-fUff-SS . 

Example: 

DEBUG 

D5000 

5000 A9 03 18 E5 F0 4C 23 91 
DEBUG 



RETURN 



5008 18 41 54 41 52 49 20 20 
DEBUG 
□ 

Dmmmm,yyyy where yyyy is greater than mmmm, shows the contents of 
addresses mmmm to yyyy. 

Example: 

DEBUG 

D5000,500F BUI 

5000 A9 03 18 E5 F0 4C 23 91 
500B 18 41 54 41 52 49 20 20 
DEBUG 

[] 

The display can be stopped by pressing the BREAK key. 

C or Cmmmm Change Memory 

Cmmmm < yy changes the contents of address mmmm to yy. 

Example: 

DEBUG 



return] 



DEBUG 

[] 

The effect of the command is to put the number 23 in location 5001. A comma 
increments the location to be changed. 

Example: 

DEBUG 
C500B <21,EF 

DEBUG 

C700B <31,,,87 SSI 

DEBUG 

[] 

The first command puts 21 and EF in locations 500B and 500C, respectively. 
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The second command puts 34 and 87 in locations 700B and 700E respectively. 



You can conveniently use the C command in conjunction with the Display 
Memory command, and you need not enter the address a second time with the C 
command. The C command will default to the last specified address. 

Example: 

D5000 fflgiEffl 

5000 AO 03 18 E5 FO 4C 23 91 
C< AA,14 t®® 



RETURN : 



5000 A A 14 18 E5 F0 4C 23 91 

DEBUG 

[] 

Mmmmm Move Memory 

Mmmmm < yyyy,zzzz copies memory from yyyy to zzzz to memory starting 
at mmmm. Address mmmm must be less than yyyy or greater than zzzz. If the 
origin and destination blocks overlap, results may not be correct. 

Example: 

DEBUG 

M1230 < 5000, 500F iSzWm 

DEBUG 

[] 

The command copies the data in location 5000-500F to location 1230-123F. 

Vmmmm Verify Memory 

Vmmmm<yyyy,zzz compares memory yyyy to zzzz with memory starting at 
mmmm, and shows mismatches. 

Example: 

DEBUG 

v7ooo< 7100,7123 mmm 

DEBUG 

[] 

The command compared the contents of 7100-7123 with the contents of 
7000-7023. There were no mismatches. 

Mismatches would be shown as follows: 

7101 00 7001 22 
7105 18 7005 10 

L or Lmmmm List Memory With Disassembly 

This command allows you to look at any block of memory in disassembled 
form. 



Examples: 

L7000 List a screen page (20 lines of code) starting at 

memory location 7000. Pressing the key 

during listing halts the listing. 



L 



RETURN 



This form of the command lists a screen page start- 
ing at the instruction last shown, plus 1. 



L7000, 0 
L7000, 7000 
L7000, G000 



RETURN 

RETURN 

RETURN 



These forms list the instructions at address 
7000 only. 



L345, 567 This form lists address 345 through 567. Only the 

last 20 instructions will actually be visible at the 
completion of the response of the system. 



The command Lmmmm differs from Dmmmm in that Lmmmm disassembles 
the contents of memory. 

Example: 

EDIT 

BUG 



DEBUG 

L5000, 0 m 

5000 A9 03 LDA #$03 

DEBUG 

[] 

This example shows that the Debugger examined the contents of memory 
address 5000 and disassembled A9 to LDA. Since A9 must have a one-byte 
operand, the Debugger made the next byte (the contents of address 5001) the 
operand. Therefore, although the debugger was only “asked” for the content of 
location 5000, it showed a certain amount of intelligence and replied by show- 
ing the instruction that started at address 5000. 

To illustrate this further, the number 03 corresponds to no machine code 
instruction, so the Debugger would interpret 03 as an illegal instruction, and 
alert you to a possible error, as shown below. 

Example: 

DEBUG 



RETURN 



5001, 03 ??? 

DEBUG 

However, if the first instruction you wrote was LDA $8A, then you would have 
obtained the following, apparently inconsistent, results while debugging: 

Example: 

DEBUG 

L5000, 00 A9 8A LDA #$8A 
DEBUG 

L5001, 0 8A TXA 



Debugging 39 




Because the disassembler starts disassembling from the first address you 
specify, you have to take care that the first address contains the first byte of a 
“real” instruction. 

A Assemble One Instruction Into Memory 

The DEBUGGER has a mini-assembler, that can assemble one assembly language 
instruction at a time. To enter the Assemble mode, type: 



Once in the Assemble mode, you stay there until you wish to return to 
DEBUGGER, which you may do by pressing (on an empty line). 

To assemble an instruction, first enter the address at which you wish to have 
the machine code inserted. The number that you enter will be interpreted as a 
hex address. Now type “ < ” followed by at least one space, then the instruction. 
You may omit an address if assembly is to be in successive locations. 

Example: 

EDIT 

BUG 1331 

DEBUG 

A SHI 

5001 <LDY $1234 OHH 
5001 AC3412 

<iny 

5004 CB 

[] SSBSBB 




DEBUG 

[] 

Since the mini-assembler assembles only one instruction at a time, it cannot 
refer to another instruction. Therefore, it cannot interpret a label. Conse- 
quently, labels are not legal in the mini-assembler. 

You can use the directives BYTE, DBYTE, and WORD. 

Gmmmm Go (Execute Program) 

This command executes instructions starting at mmmm. For example: 

G7B00 Executes instructions starting at location 7B00. 

Execution continues indefinitely. Execution is 
stopped by pressing the key (unless the pro- 

gram at 7B00 tricks or crashes the operating system). 

Tmmmm Trace Operation 

This command has the same effect as Gmmmm, except that after execution of 
each instruction the screen shows the instruction address, the instruction in 
machine code, the instruction in assembly language (disassembled by the 
debugger— not necessarily the same as you wrote it in assembly language) and 
the values of Registers A, X, Y, P and S. 

The execution stops at a BRK instruction (machine code 00) or when you press 
the key on the keyboard. 
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I 



Example: 

DEBUG 



RETURN 



5000 


A9 


03 


LDA 


#$03 


A = 03 


X = 02 


Y = 03 


P = 34 


S = 05 


5002 


18 




CLC 




A = 03 


X = 02 


Y = 03 


P = 34 


S = 05 


5003 


E5 


F0 


SBC 


$F0 


A = 03 


X = 02 


Y = 03 


P = 34 


C/2 

II 

o 

cn 


5005 


4C 


23 71 


JMP 


$7123 


A = 03 


X = 02 


II 

O 

C3 


P = 34 


S = 05 


7123 


00 




BRK 




A = 03 


X = 02 


Y = 03 


P = 34 


S = 05 



DEBUG 

S or Smmnim Step Operation 

This command has the same effect as T or Tmmmm, except that only one 
instruction is executed. To step through a program, type S mwm repeatedly 
after the first command of Smmmm iKBliliBjB 

X Exit 

To return to the Editor type: 



i return j 
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APPENDIX 1 



ERRORS 



When an error occurs, the console speaker gives a short “beep” and the error 
number is displayed. 

Errors numbered less than 100 refer to the Assembler Editor cartridge, as 
follows: 

ERROR 

NUMBER 

1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 

9. 

10 . 

11 . 

12 . 

13. 

14. 

15. 

16. 

17. 

18. 

19. 

Errors 

Errors numbered more than 100 refer to the Operating System and the Disk 
Operating System. For a complete list of DOS errors, refer to the DOS manual. 

128 key pressed during an I/O operation. 

130 A nonexistent device specified for I/O. 

132 The command is invalid for the device. 

136 EOF. End of tile read has been reached. This error may occur when 
reading from cassette. 

137 A record was longer than 256 characters. 

138 The device specified in the command does not respond. Make sure 
the device is connected to the console and powered. 

139 The device specified in the command does not return an Acknowl- 
edge signal. 



The memory available is insufficient for the program to be assem- 
bled. 

For the command “DEL xx,yy” the number xx cannot be found. 
There is an error in specifying an address (mini-assembler). 

The file named cannot be loaded. 

Undefined label reference. 

Error in syntax of a statement. 

Label defined more than once. 

Buffer overflow. 

There is no label or * before “ = ”. 

The value of an expression is greater than 255 where only one byte 
was required. 

A null string has been used where invalid. 

The address or address type specified is incorrect. 

Phase error. An inconsistent result has been found from Pass 1 to 
Pass 2. 

Undefined forward reference. 

Line is too large. 

Assembler does not recognize the source statement. 

Line number is too large. 

LOMEM command was attempted after other command(s) or instruc- 
tion(s). LOMEM, if used, must be the first command. 

There is no starting address. 
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140 Serial bus input framing error. 

142 Serial bus data frame overrun. 

143 Serial data checksum error. 

144 Device done error. 

145 Diskette error: Read-after-write comparison failed. 

14G Function not implemented. 

162 Disk full. 

165 File name error. 
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ASSEMBLER MNEMONICS 

(Alphabetic List) 



ADC Add Memory to Accumulator with Carry 
AND AND Accumulator with Memory 

ASL Shift Left (Accumulator or Memory) 

BCC Branch if Carry Clear 

BCS Branch if Carry Set 

BEQ Branch if Result = Zero 

BIT Test Memory Against Accumulator 

BMI Branch if Minus Result 

BNE Branch if Result ^ Zero 

BPL Branch on Plus Result 

BRK Break 

BVC Branch if V Flag Clear 

BVS Branch if V Flag Set 

CLC Clear Carry Flag 

CLD Clear Decimal Mode Flag 

CLI Clear Interrupt Disable Flag (Enable Interrupt) 

CLV Clear V Flag 

CMP Compare Accumulator and Memory 

CPX Compare Register X and Memory 

CPY Compare Register Y and Memory 

DEC Decrement Memory 

DEX Decrement Register X 

DEY Decrement Register Y 

EOR Exclusive-OR Accumulator with Memory 

INC Increment Memory 

INX Increment Register X 

INY Increment Register Y 

JMP Jump to New Location 

JSR Jump to Subroutine 

LDA Load Accumulator 

LDX Load Register X 

LDY Load Register Y 

LSR Shift Right (Accumulator or Memory) 

NOP No Operation 

ORA OR Accumulator with Memory 

PHA Push Accumulator on Stack 

PHP Push Processor Status Register (P) onto Stack 

PLA Pull Accumulator from Stack 

PLP Pull Processor Status Register (P) from Stack 

ROL Rotate Left (Accumulator or Memory) 

ROR Rotate Right (Accumulator or Memory) 

RTI Return from Interrupt 

RTS Return from Subroutine 

SBC Subtract Memory from Accumulator with Borrow 

SEC Set Carry Flag 

SED Set Decimal Mode Flag 

SEI Set Interrupt Disable Flag (Disable Interrupt) 
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STA Store Accumulator 

STX Store Register X 

STY Store Register Y 

TAX Transfer Accumulator to Register X 

TAY Transfer Accumulator to Register Y 

TSX Transfer Register SP to Register X 
TXA Transfer Register X to Accumulator 

TXS Transfer Register X to Register SP 

TYA Transfer Register Y to Accumulator 
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SPECIAL SYMBOLS 



Below we give a list of special symbols that have a restricted meaning to the 
Assembler. You should avoid using these symbols as a matter of course. Most 
attempts to use these symbols in any but their special sense will result in errors. 
They may be used, without their special meaning, in comments and in the 
operands of memory reservation directives. 



5 The semicolon is used to indicate the start of a comment. Everything 
between the semicolon and RETURN appears in the listed form of the 
program and is ignored by the Assembler. When comments take more 
than one line, start each new line with a semicolon. 

# The # sign is used as the first symbol of an immediate operand, as in 
LDX #24. 

$ The $ sign is used before numbers to signify that they are to be interpreted 
as hex numbers. For example, LDX #$34. 

* The asterisk is used to signify the value of the current location counter. For 
example, the instruction in line 50 gives the symbol HERE a value equal to 
5 or more than the number in the current location counter: 

50 HERE = * + 5 



Example: 

18 *=$911 

19 RTS 

20 * = * + $F 

21 TAX 



When this example is assembled, line 18 causes the location counter to be $0911, 
RTS is placed in location $0911, line 20 causes the location counter to be 
increased from $0912 to $0921, and TAX is placed in $0921. This leaves 15 
empty bytes between the RTS and the TAX. 

The asterisk also signifies multiplication (see Appendix 6). The Assembler uses 
the syntax of the statement to distinguish the two meanings of the asterisk. 

Register names: 

A Accumulator 
X X Register 
Y Y Register 
S Stack Pointer 
P Processor Status Register 
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TABLE OF HEX DIGITS WITH CORRESPONDING 
OP CODE MNEMONICS AND OPERANDS 
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APPENDIX 5 
EXPRESSIONS 



When an instruction or directive calls for a number in the operand, the number 
may be given as an “expression,” the number used being the value of the 
expression. An expression is really just a formula. 



expressions are made up of operators and terms. Terms are either numbers or 
labels which stand for numbers. An expression containing a label term that 
does not have a numeric value will be flagged as an error. 



There are five operators; four are arithmetic, and one is logical. 

Addition is signified by the sign + 

Subtraction is signified by the' sign 
Multiplication is signified by * 

Division is signified by / 

Logical AND is signified by 



Expressions must not contain parentheses. 



Expressions are evaluated from left to right. 



Examples: 



100 


*=$90 + 1007 


200 


JMP 


3+2*25*4/5-3 


300 


JMP 


0097 


400 


JMP 


$0061 


100 


LDA 


.WUM1 + NUM2 



600 


LDA 


LABEL &> $00FF 


610 


STA 


$CC 


620 


LDA 


LABEL/256 


630 


STA 


$CD 



These instructions are equivalent. 



NUM1 and NUM2 must be defined some- 
where in the program. The instruction 
loads the Accumulator with the sum of 
the numbers in the locations NUM1 and 
NUM2. 

This yields the low order byte of the value 
of LABEL. 

This yields the high order of byte of the 
value of LABEL. 
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APPENDIX 6 



DIRECTIVES 



. OPT Operand 



. TITLE “NAME” 

. PAGE ‘MESSAGE” 

. TAB nl,n2,n3 

. BYTE a,b...n 
. BYTE “AB...N” 

. DBYTE a, b,...n 



. WORD a, b,...,n 



AB = Expression 



* = Expression 



. IF Expression 
. LABEL 

. END 



specifies an option. Operand can be LIST or NOLIST, 
OBJ or NOOBJ, ERRORS or NOERRORS, EJECT or 
NOEJECT. (Default options are LIST, OBJECT, ERRORS, 
and EJECT.) 

causes NAME to be printed at the top of each page. 

produces a blank space in the listing, then causes 
MESSAGE to be printed after NAME. 

controls the spacing of the fields of Op Code 
Mnemonic, Operand, and Comment as they appear in 
the listing. 

places in successive memory locations the values of the 
expressions a, b, ..., n (one byte for each value). 

places in successive memory locations the ATASCII 
values of A, B, ..., N. 

places in successive pairs of memory locations the 
values of the expressions a, b, ..., n (two bytes for each 
value, high byte first). 

places in successive pairs of memory locations the 
values of the expressions a, b, ..., n (two bytes for each 
value, low byte first). 

makes the Label AB equal to the value of the expres- 
sion (up to FFFF hex). 

makes the Program Counter equal to the value of the 
expression (up to FFFF hex). 



assembles following code, up to . LABEL, if and only if 
expression evaluates to zero. 

indicates the end of the program to be assembled. 
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APPENDIX 7 



AT ASCII CHARACTER SET 
AND HEXADECIMAL TO 
DECIMAL CONVERSION 
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A f 



o <y 


& 


cr -o 


119 


77 


w 


120 


78 


X 


121 


79 


y 


122 


7 A 


z 


123 


7B 


□ 


124 


7C 


1 


125 


7D 


□ 


126 


7E 


□ 


127 


7F 


n 


128 


80 


(inverse ch 
begin) 


129 


81 




130 


82 




131 


83 




132 


84 




133 


85 




134 


86 
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Notes: 

1. ATASCII stands for ATARI ASCII. Letters and numbers have the same values as those in ASCII, but 
some of the special characters are different. 

2. Except as shown, characters from 128-255 are reverse colors of 1 to 127. 

3. Add 32 to upper case code to get lower case code for same letter. 

4. To get ATASCII code, tell computer (direct mode) to PRINT ASC (“ ”) Fill blank with letter, 

character, or number of code. Must use the quotes! 
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APPENDIX 8 



REFERENCES 



ATARI PUBLICATIONS 

Obtainable from your ATARI dealer, or ATARI Consumer Division, Customer 
Support, 1195 Borregas Avenue, Sunnyvale, CA 9408G 



ATARI 400™ Operator’s Manual C014768 

ATARI 800™ Operator’s Manual C014769 

ATARI 810™ Operator’s Manual CO14760 

ATARI 815™ Operator’s Manual C016377 

ATARI Disk Operating System II Reference Manual 
ATARI 410™ Operator’s Manual CO14810 



OTHER PUBLICATIONS 
6502, Programming Manual 

SYNERTEK, 3050 Coronado Drive, Santa Clara, CA 95051 or 
MOS Technology, 950 Rittenhouse Road, Norristown, PA 19401 

6502 Assembly Language Programming by Lance Leventhal 
Osborne/McGraw-Hill, 630 Bancroft Way, Berkeley, CA 94710 

Programming the 6502 by Rodney Zaks 
Sybex, 2020 Milvia Street, Berkeley, CA 94704 
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APPENDIX 9 

USING THE ASSEMBLER CARTRIDGE 

TO BEST ADVANTAGE 









2embl vTn p^ dlt Cartr , idge j is desi ^ ned t0 support intermediate-level 
S u edC ataIt’" development. It is good enough in this function to 

be used by ATARI s own programmers for some software development. 

SfwarJ d? l6 i iS Pm ? rful and " can do a ^ reat deal > but it is not a professional 
development system. It is not well suited for development of large 

vonS gUagC Pr ° gram ®’ A S°° d rule thumb is: take the amount of RAM 
you have in your system and divide by ten to find the largest amount of object 
code you can comfortably develop with this cartridge. Thus, an ATARI Personal 
Computer System with 16K of RAM can be used to develop object code 
I ogiams up to about 1G00 bytes in size. Of course, you can stretch your 
memory by ehminatmg all explanatory comments and using very short labels 
This wjl allow you to ft in much more code, but it will make your proSi 
difficult to revise at a later time. ^ & 

£w,:r m T end r tl0n S that , thiS cartrid ge is best used to develop machine 
language subroutines that enhance the speed and power of BASIC programs 

^iTmach n i gUagC C ° mplements BASIC vei T well; the combination of B ASIC 
id machine language is extremely powerful. You can unleash almost all of the 

C:houkl d L y e°BASK T t RI ^ ^ this combinafion 

you should use BASIC for most of your programming; it is easy to write and 

•umli£fio 0 ns S !f° U C v e a f embly lai ?g ua S e on] y when necessary. There are five 
applications of machine language that are particularly appropriate: 






fo provide certain special logical 
BASIC 



operations not readily available from 



To generate special sound effects that BASIC is too slow to generate 

• To generate high-speed graphics and animation 

• To utilize the interrupt capabilities of the machine 



To accomplish high-speed complex logical calculations and manipulations 

Most of these applications are situations that call for high speed; in general the 
pi unary advantage of machine language is its higher speed. Machine language 

thousand I' 00 ' tC f n ! ime ; s / ast f r than BASIC and in special cases, can be up to a 
fln°,w d T S f f ter '. We do not recommend using machine language for 
floating point arithmetic or for I/O to and from peripherals (except the screen) 

ISSS use machine language only when its speed advantages 
t gh the difficulties of programming in assembly language. 

, USe ° f aSS6mbly language squires a thorough knowledge of the 
if y ” and operatm § s y fitem of the host machine. Unfortunately, the ATARI 
ersonal Computer System is far too complex to cover adequately in a brief 
appendix. We therefore provide four commented sample programs which 
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show how to execute some of the most commonly used functions. These 
programs are meant only for demonstration purposes; they certainly do not 
exercise the full power of the machine. You may wish to enhance them, adding 
whatever features you desire. In this way you will learn more about the ATARI 
Personal Computer System. 



All four programs have been written to reside on page 6 of memory. These 256 
bytes have been reserved for your use. On page zero, only 7 bytes have been 
reserved for your use by the BASIC cartridge; they are locations $CB through 
$D1 (203 through 209). Locations $D4 and $D5 (212 and 213) are also usable; they 
are used to return parameters from machine language routines to BASIC 
through the USR function. Furthermore, locations $D6 through $F1 are used 
only by the floating point package; you may use them from BASIC USR calls if 
you do not mind having them altered every time an arithmetic operation is 
performed. If your program runs only with the Assembler Editor cartridge and 
not the BASIC cartridge you may use zero page locations $B0 through $CF. You 
will have to be very sparing in your use of page zero locations, as nine safe 
locations will not take you far. It is not wise to usurp other locations on page 
zero, as they are used by the operating system and BASIC; there is no way to 
know if you thereby sabotage some vital function and crash the system until it 
is too late. For the moment, we recommend that you limit yourself to programs 
that fit onto page 6 and use less than 9 bytes of page zero. The four sample 
programs meet that restriction; later we will show you how to make larger 
programs with BASIC. 



Our first sample program is very simple: it takes two 16-bit numbers, exclusive 
OR’s them together, and returns the resulting 16-bit number to BASIC. It is only 
17 bytes long and uses only 4 bytes of page zero. We will use it as a vehicle to 
show you the rudiments of interfacing machine language to BASIC. Here’s how: 
First, type in the program with the Assembler Editor cartridge in place. Make 
sure that you have typed it in properly by assembling the program (the 
command ASM) and verifying that no errors are flagged to you. If it squawks 
unpleasantly, you have offended its delicate sensitivities; note the line number 
where the error occurred (CONTROL-1 is a handy way to stop the listing so you 
can see what happened). Then list the offending line and correct the typo. You 
may rest assured that the program as we list it will indeed assemble without 
errors; if you type it in exactly as listed it will work fine. Now assemble the 
program with the object code going to your nonvolatile storage medium (either 
diskette or cassette). If you have a disk drive, type in: 

ASM„#D:EXCLOR.OBJ 
If you have a Program Recorder, type in: 

ASM„#C: 

Follow normal procedures for using these devices. After the object code is 
stored to your diskette or cassette, open the cartridge slot cover and replace the 
Assembler Editor cartridge with the BASIC cartridge. Close the cover and when 
you see the READY prompt, load the program from diskette or cassette tape into 
RAM. 



If you have a diskette, type DOS to call DOS, then type L to load a binary file. 
When it asks what file to load, respond with: 



EXCLOR.OBJ HSai 



When it returns the SELECT ITEM nromnt twe r 

you have a cassette tvoe in n n n , /?, B to return to BASIC. If 



?PEEK(1536) 



msi wm^ss 



A = USR(1536, 1, 33: ?A 



RETURN 



S^rS'leatS wT’" d by P T Kng ,he ™ lue 2 ’ 1 exclusive 

togethei . They must be integers between 0 and 65535. 

S"E-r.5Tr-iSS^ 

SaSSSaSSFi^SSs 

the program with the Assembler VrVt ^ a same P roce dure as before, enter 
cassettefsave M^teh to Mac and In JT" d «\ asse f bte #«>the diskette or 
the program with: ’ °“ d 2 machme language code. Then run 

A = USR(1536, 50, 10, 50, 200) 

not'tXfvery ‘“hortTtff alwfriaf “ , “J' d ," P “ d y(1 “ hear a 
with different values of the last f P ateau t dn d a long decay. Experiment 

generated 'r’T’ >» 

(1536) or the program will almost surely crash g ^ fll ' St parameter 

ggggss 

GR. 19; A = USR(1536) mWWm 

still be intact and usable. X 1 * 13 832 key ’ ,he Program will 
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The last sample program demonstrates a very useful capability of the ATARI 
Personal Computer System— the display list interrupt. Perhaps you have been itch- 
ing to have more than five colors on the screen. With display list interrupts you 
can have up to 128 colors. Here’s the idea behind it: the ATARI display system 
uses a display list and display memory. The display list is a sequence of instruc- 
tions that tell the computer what graphics format to use in putting information 
onto the screen. The display memory is the information going onto the screen. 
The address of the beginning of the display list can be found in locations 560 and 
561 (decimal). The address of the beginning of the display memory can be found 
in locations 88 and 89 (decimal). Wondrous things can be done by changing the 
display list; this program demonstrates only one of the capabilities of the 
display list system. If bit 7 of a display list instruction is set (equal to 1), then the 
computer will generate a non-maskable interrupt for the 6502 when it en- 
counters that display list instruction. 

If we place an interrupt routine which changes the color values in the color 
registers, the color on the screen will be changed each time a display list inter- 
rupt is encountered. This program consists of two parts: an initializing routine 
which sets up the display list interrupt vectors, sets all of the display list instruc- 
tions to generate display list interrupts, and lastly, enables the display list inter- 
rupts. The second routine actually services the display list interrupts by chang- 
ing the color value in the color registers every time it is called. This routine is 
designed to operate in GRAPHICS 5 mode; it will put all 128 colors onto the 
screen. (Is that enough for you?) To see it in action, follow the familiar pro- 
cedure for entering, assembling, saving, and loading the program. Then key in 
the following BASIC immediate instruction: 

GR. 5: FOR 1= 0 TO 3: COLOR I: FORJ = 20*I TO 20*1 + 19: PLOTJ, 3: 

DRAWTOJ, 39: NEXT J : NEXT I: A = USR(1536) 

We hope that these four sample programs have given you a clearer idea of how 
your ATARI Assembler Editor cartridge might be useful. There are some more 
advanced techniques for getting even more use out of your cartridge. The first 
problem many programmers encounter arises when they attempt to write a 
program larger than 256 bytes long. It will no longer fit onto page 6 and the pro- 
grammer must find a new place to put the program. The problem is made 
worse by the fact that the Operating System and BASIC use memory all over the 
address space. The programmer will have a hard time finding a safe place in 
memory where the machine language routine will not be wiped out by BASIC 
or the Operating System. There are a number of solutions to this problem; each 
solution has advantages and disadvantages. We recommend the following ap- 
proach, which is difficult to understand but is also the most useful and safest 
route. What we are going to do is store the machine language program inside a 
BASIC program and then touch it up so that it will run from anywhere in 
memory. 

We begin by writing an assembly language program with the Assembler Editor 
cartridge. Originate the program near the top of your available memory. For ex- 
ample, if you have 2K of object code and a 16K machine, originate the program 
at the 12K boundary with the directive 1 * =$3000’. This leaves 4K of space— 2K 
for your program, IK for a GRAPHICS mode 0 display, and IK of extra space for 
good measure. Now go through the procedure of assembling the object code to 
diskette or cassette, changing the cartridges, and loading the object code into 
memory. Calculate the decimal addresses of the beginning and end of your ob- 
ject code. Let us say that your program is 2179 bytes long. It begins at $3000 or 
12288 decimal, so the last byte is at 14466. Print PEEK(12288) and PEEK(14466) to 
verify that these addresses really do contain the first and last bytes of your pro- 
gram. Remember, the computer will print the results in decimal, not hex- 
adecimal, so you wall have to convert in your head or with the computer. 



Now start writing a BASIC program, begin with: 



2 DIM E$(2179) 



Then add this subroutine (which you can delete later): 

25000 A=90*J + 1:B = A + 89:IF B > LIMIT THEN B = LIMIT:?“LAST LINE” 
25010?J + 5;“E$(”;A;“,”,B,”) = ”;CHR$(34); 

25020 FOR I = A TO B:?“ H!il El ”:CHR$(PEEK)I + C))::NEXT I 
25030 ?CHR$(34)J=J+1:RETURN 



Here the a symbol means that you press the escape key twice. Now type 

in the following direct commands: 



t=o nyum 

C = 12287 
LIMIT = 2179 



RETURN 



RETURN 



The value of C is the address of the byte before the first byte of your program. 
The value of LIMIT is the length of your object program. Now type GOSUB 
25000 mu. 



The computer will print a BASIC line onto the screen. It will look very 
strange— all sorts of strange characters inside a string. They are the screen 
representation of your object code. To make this line part of your BASIC prgram 
simply move the cursor up to the line and press §j||||lggjf. You might reassure 
yourself that you were successful by entering: 



LIST 5 



and verifying that line 5 really did go in. Now type GOSUB 25000 again 

and another line will be printed. Enter this one the same way as before. 
Continue this process of printing and entering lines until the entire object 
program has been encoded inside BASIC statements. You will know you have 
reached this point when the computer prints “LAST LINE” onto the screen. 



There is one possible hitch with this process. If you have a hex code of $22 
(decimal value 34) anywhere in your code it will be put onto the screen as a 
double quotation mark. This will confuse the BASIC interpreter, which will 
give you a syntax error when you try to enter the line. If this happens, carefully 
count which byte is the offender and write down the index of the array which 
should contain the double quotation mark. Then go back and replace the 
offending quotation mark with a blank space; that will keep the BASIC 
interpreter happy. Make note of all such occurrences. When you are done 
entering the characters, type in a few more lines like: 



30 E$(292, 292) = CHR$(34) 



This line puts the double quotation mark into the 292nd array element by brute 
force. It should come immediately after the lines that declare the string. You 
should have a line similar to this for each instance of the double quotation mark. 
Make sure that you have counted properly and put the double quotation marks 
into the right places. 



Now your object program is a part of the BASIC program. You can SAVE and 
LOAD the BASIC program and the object program will be saved and loaded 
along with it— a great convenience. You can run the object program by running 
the BASIC program and then executing the command: 
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A = USR(ADR(E$)) 



But there is still another possible hitch. The 6502 machine language code is not 
fully relocatable; any absolute memory references to the program are certain to 
fail. For example, suppose your program has a jump-to-subroutine (JSR) 
instruction that refers to a subroutine within the object code. This instruction 
would tell it to jump to a specific address. Unfortunately, your program has no 
way of knowing at what specific address that subroutine is stored and thus will 
almost certainly jump to the wrong address. The problem arises from the fact 
that BASIC might move your object program almost anywhere in memory. 

There are several solutions to this problem. The simplest solution is to write 
fully relocatable code; that is, code with no JMP’s, no JSR’s and no data tables 
enclosed within it. Put all data tables and subroutines onto page 6. If you still 
need more space, put very large data tables into the BASIC string and point to 
them indirectly. Replace long JMP’s with a bucket brigade of branch 
instructions. These techniques should allow you to write large machine 
language programs. 



Example 1. 

10 ; 

20 ; ROUTINE EXCLOR 

30 ; PERFORMS EXCLUSIVE OR OPERATION ON 

40 ; TWO BYTES PASSED THROUGH THE STACK 

50 ; PASSES RESULTS DIRECTLY THROUGH USR FUNCTION 



0000 




80 




* — 


$0600 




oocc 




90 


TEMPL 


= 


$CC 


TEMPORARY HOLDING LOCATION 


00CD 




0100 


TEMPH 


= 


$CD 


TEMPORARY HOLDING LOCATION 


00D4 




0110 


RESLTL 


= 


$D4 


ADDRESS FOR PASSING RESULTS 


00D5 




0120 


RESLTH 


= 


$D5 


ADDRESS FOR PASSING HIGH RESULT 


0600 


68 


0130 


EXCLOR 


PLA 






0601 


68 


0140 




PLA 






0602 


85CD 


0150 




STA 


TEMPH 


SAVE HIGH BYTE 


0604 


68 


0160 




PLA 






0605 


85CC 


0170 




STA 


TEMPL 


SAVE LOW BYTE 


0607 


68 


0180 




PLA 






0608 


45CD 


0190 




EOR 


TEMPH 


PERFORM HIGH EXCLUSIVE OR 


060A 


85D5 


0200 




STA 


RESLTH 


STORE RESULT 


060C 


68 


0210 




PLA 






060D 


45 CC 


0220 




EOR 


TEMPL 


PERFORM LOW EXCLUSIVE OR 


060F 


85D4 


0230 




STA 


RESLTL 


STORE RESULT 


0611 


60 


0240 




RTS 




WHAT COULD BE SIMPLER? 


0612 




0250 




.END 







Example 2. 

10 ; 

20 ; ROUTINE NOTE 

30 ; GENERATES NOTES WITH CONTROLLABLE ATTACK AND DECAY 

40 ; TIMES 

50 ; CALL FROM BASIC WITH COMMAND: 

60 ; A = USR(1536, F, A, P, D) 
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70 

80 

90 

0100 

0110 

0120 

0130 



0000 




0140 


D200 




0150 


D201 




0160 


oocc 




0170 


00CD 




0180 


00CE 




0190 


0600 


68 


0200 


0601 


68 


0210 


0602 


68 


0220 


0603 


8D00D2 


0230 


0606 


68 


0240 


0607 


85CC 


0250 


0608 


68 


0260 


060A 


68 


0270 


060B 


68 


0280 


060C 


85CD 


0290 


060E 


68 


0300 


060F 


68 


0310 


0610 


85CE 


0320 



Xr 0330 



0340 

0350 



0612 


A9A0 


0360 


0614 


8D01D2 


0370 


0617 


A6CC 


0380 


0619 


204106 


0390 


061C 


18 


0400 


061D 


6901 


0410 


061F 


C9B0 


0420 


0621 


D0F1 


0430 


J 




0440 






0450 






0460 


0623 


A90E 


0470 


0625 


A6CD 


0480 


0627 


204106 


0490 


062A 


38 


0500 


062B 


E901 


0510 


062D 


D0F6 


0520 






0530 






0540 






0550 


062F 


A9AF 


0560 


0631 


8D01D2 


0570 


0634 


A6CE 


0580 


0636 


204106 


0590 



WHERE 

F IS THE FREQUENCY 
A IS THE ATTACK TIME 
P IS THE PEAK TIME 
D IS THE DECAY TIME 

ALL TIMES GIVEN IN UNITS OF 



* = 


$0600 


AUDF1 


$D200 


AUDC1 


$D201 


ATTACK 


$CC 


PEAK 


$CD 


DECAY 

NOTE PLA 

PLA 
PLA 


$CE 


STA 

PLA 


AUDF1 


STA 

PLA 

PLA 

PLA 


ATTACK 


STA 

PLA 

PLA 


PEAK 


STA 


DECAY 


3 

; ATTACK LOOP 


5 

LDA 


#$A0 


ATLOOP STA 


AUDC1 


LDX 


ATTACK 


JSR 

CLC 


DELAY 


ADC 


#$01 


CMP 


#$BO 


BNE 


ATLOOP 


; PEAK LOOP 


3 

LDA 


#$OE 


PKLOOP LDX 


PEAK 


JSR 

SEC 


DELAY 


SBC 


#$01 


BNE 


PKLOOP 


3 

; DECAY LOOP 


3 

LDA 


#$AF 


DCLOOP STA 


AUDC1 


LDX 


DECAY 


JSR 


DELAY 



1.6 MILLISECONDS 

AUDIO FREQUENCY REGISTER 
AUDIO CONTROL REGISTER 
ATTACK TIME 
PEAK OR PLATEAU TIME 
DECAY TIME 



SET FREQUENCY 
SET ATTACK TIME 



SET PEAK TIME 



SET DECAY TIME 



START WITH ZERO VOLUME 
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0639 


38 


0600 


SEC 




063A 


E901 


0610 


SBC 


#$01 


063C 


C99F 


0620 


CMP 


#$9F 


063E 


D0F1 


0630 


BNE 


DCLOOP 


0640 


60 


0640 


RTS 








0650 


> 




0641 


A013 


0660 


DELAY LDY 


#$13 


0643 


88 


0670 


DELAY2 DEY 




0644 


DOFD 


0680 


BNE 


DELAY2 


0646 


CA 


0690 


DEX 




0647 


DOFS 


0700 


BNE 


DELAY 


0649 


60 


0710 


RTS 




064A 




0720 


.END 




Example 3. 












10 


5 








20 


5 

; ROUTINE SPLAY 








40 


; PUTS A PRETTY DISPLAY ONTO THE SCREEN 






50 


; CALL FROM BASIC WITH THE FOLLOWING COMMANDS 






60 


; GR. 19: A = USR(1536) 






70 


; EXIT PROGRAM WITH @ | 






80 


5 








90 


> 








0100 


* _ 


$0600 


oocc 




0110 


TEMP 


$CC TEMPORARY LOCATION 


00CD 




0120 


XLOC 


$CD HORIZONTAL POSITION OF PIXEL 


OOCE 




0130 


YLOC 


$CE VERTICAL POSITION OF PIXEL 


OOCF 




0140 


DIST 


$CF DIST. OF PIXEL FROM SCREEN CENTER 


00D0 




0150 


PHASE 


$D0 COLOR PHASE 


00D1 




0160 


COLOR 


$D1 COLOR CHOICE 


0058 




0170 


SAVMSC 


$58 POINTER TO BEG. OF DISPLAY MEMORY 


02C4 




0180 


COLORO 


$02C4 LOCATION OF COLOR REGISTERS 


D20A 




0190 


RANDOM 


$D20A HARDWARE RANDOM NUMBER LOCATION 


0600 


68 


0200 


SPLAY PLA 


POP A ZERO FROM STACK 


0601 


85 DO 


0210 


STA 


PHASE STORE IT IN PHASE 


0603 


AA 


0220 


TAX 


SET COUNTER 






0230 


y 








0240 


; THIS IS THE MAIN PROGRAM LOOP 






0250 


; FIRST WE RANDOMLY CHOOSE THE SCREEN LOG. TO MODIFY 






0260 


; SCREEN IS 40 PIXELS HORIZONTALLY BY 24 PIXELS VERTICALLY 






0270 


; WITH 4 HORIZONTALLY ADJACENT PIXELS PER BYTE 






0280 


; HENCE THERE ARE 10 BYTES PER HORIZONTAL ROW 






0290 


; AND 24 ROWS FOR A TOTAL OF 240 BYTES 






0300 


; TO REPRESENT THE SCREEN 






0310 


y 








0320 


y 








0330 


y 




0604 


AD0AD2 


0340 


BEGIN LDA 


RANDOM GET A RANDOM NUMBER 


0607 


290F 


0350 


AND 


#$0F MASK OFF LOWER NYBBLE 


0609 


C90A 


0360 


CMP 


#$0A MUST BE SMALLER THAN 10 


060B 


B0F7 


0370 


BCS 


BEGIN IF NOT, TRY AGAIN 
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060D 

060F 

0610 

0612 

0614 

0616 

0617 

0619 
061B 
06 IE 

0620 
0622 
0624 
0626 
0627 
0629 
062B 
062D 
062E 



85CD 

38 

E905 

1005 

49FF 

18 

6901 
85CF 
AD0AD2 
29 IF 
C918 
B0F7 
85 CE 
38 

E90C 

1005 

49FF 

18 

6901 



0630 18 

0631 65CF 

0633 65D0 



0635 29 IF 

0637 4A 

0638 4A 

0639 4A 
063 A 85 D1 



063C AD0AD2 
063F 2903 

0641 A8 

0642 F007 



0644 06D1 

0646 06D1 

0648 88 

0649 D0F9 



064B A5CE 
064D 0A 



0380 
0390 
0400 
0410 
0420 
0430 
0440 
0450 
0460 
0470 
0480 
0490 
0500 
0510 
0520 
0530 
0540 
0550 
0560 
0570 
0580 
0590 
0600 
0610 
0620 
0630 
0640 
0650 
0660 
0670 
0680 
0690 
0700 
0710 
0720 
0730 
0740 
0750 
0760 
0770 
0780 
0790 
0800 
0810 
0820 
0830 
0840 
0850 
0860 
0870 
0880 
0890 
0900 



XA 

TRYAGN 



STA 

SEC 

SBC 

BPL 

EOR 

CLC 

ADC 

STA 

LDA 

AND 

CMP 

BCS 

STA 

SEC 

SBC 

BPL 

EOR 

CLC 

ADC 



XLOC STORE THE RESULT 



GET X-DISTANCE FROM CENTER 
IS IT POSITIVE OR NEGATIVE? 

IF NEGATIVE, MAKE IT POSITIVE 



#$05 
XA 
#$FF 

#$01 

DIST SAVE THE ABSOLUTE VALUE 

RANDOM GET ANOTHER RANDOM NUMBER 
■^IF MASK OFF LOWER 5 BITS 
#$18 MUST BE SMALLER THAN 24 

TRYAGN (BECAUSE THERE ARE ONLY 24 ROWS) 
YLOC STORE THE RESULT 



#$0C 

XB 

#$FF 

#$01 



GET Y-DIST FROM CENTER OF SCREEN 
IS IT POSITIVE OR NEGATIVE? 

IF NEGATIVE, MAKE IT POSITIVE 



; NOW CALCULATE THE COLOR TO PUT INTO THIS POSITION 
> 

XB 



CLC 

ADC DIST 
ADC PHASE 



TOTAL DIST FROM CENTER OF SCREEN 
COLOR PHASE OFFSET 



: BITS 3 AND 4 NOW GIVE THE COLOR TO USE 

MASK OUT BITS 5, 6, AND 7 



AND #$1F 
LSR A 
LSR A 

LSR A SHIFT OFF BITS 0, 1, AND 2 

STA COLOR STORE RIGHT-JUSTIFIED RESULT 

; NOW WE MUST DETERMINE WHICH OF THE 4 PIXEI S 
; IN THE BYTE GET THE COLOR 

LDA random 

AND #$03 GET A RANDOM NO. BETWEEN 0 AND 3 
USE IT AS A COUNTER 
BEQ NOSHFT SKIP AHEAD IF IT IS 0 

> 

’ SHIF T OVER TWICE FOR EACH STEP IN Y 

J 

SHFTLP ASL COLOR 
ASL COLOR 
DEY 

BNE SHFTLP 



S N °" " E MUST calculate where in memory to put our 

NOSHFr LDA YLOC GET VERTICAL POSITION 

ASL A YLOC *2 
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064E 


85CC 


0910 


STA 


TEMP SAVE IT FOR A FEW MICROSECONDS 


0650 


0A 


0920 


ASL 


A 


0651 


OA 


0930 


ASL 


A YLOC*8 


0652 


65 CC 


0940 


ADC 


TEMP ADD IN YLOC*2 






0950 


3 








0960 


; RESULT IN ACCUMULATOR IS YLOC*10 






0970 


; REMEMBER, THERE ARE TEN BYTES PER SCREEN ROW 






0980 


3 




0654 


65CD 


0990 


ADC 


XLOC 






1000 


3 








1010 


; RESULT IS MEMORY LOCATION OF DESIRED PIXEL GROUP 


0656 


A8 


1020 


TAY 




0657 


A5D1 


1030 


LDA 


COLOR GET COLOR BYTE 


0659 


9158 


1040 


STA 


(SAVMSC)jY PUT IT ONTO THE SCREEN 


065B 


CA 


1050 


DEX 


WE SHALL PUT 254 MORE SQUARES 


065C 


D0A6 


1060 


BNE 


BEGIN ONTO THE SCREEN 






1070 


3 








1080 


; END OF MAIN INNER LOOP 






1090 


3 




065E 


C6D0 


1100 


DEC 


PHASE STEP COLOR PHASE FOR EXPLOSION 


0660 


A5D0 


1110 


LDA 


PHASE 


0662 


291F 


1120 


AND 


#$1F EVERY 32 PHASE STEPS 


0664 


D09E 


1130 


BNE 


BEGIN WE CHANGE COLOR REGISTERS 






1140 


; THIS SECTION USES BITS 5 AND 6 OF PHASE 






1150 


; TO CHOOSE WHICH COLOR REGISTER TO MODIFY 






1160 


3 




0666 


A5D0 


1170 


LDA 


PHASE 


0668 


4A 


1180 


LSR 


A 


0669 


4A 


1190 


LSR 


A 


066A 


4A 


1200 


LSR 


A 


066B 


4A 


1210 


LSR 


A 


066C 


4A 


1220 


LSR 


A 


066D 


2903 


1230 


AND 


#$03 


066F 


AA 


1240 


TAX 








1250 


3 




0670 


AD0AD2 


1260 


LDA 


RANDOM CHOOSE A RANDOM COLOR 


0673 


9DC402 


1270 


STA 


COLORO,X PUT NEW COLOR INTO COLOR REG. 


0676 


4C0406 


1280 


JMP 


BEGIN START ALL OVER 


0679 




1290 


.END 




Example 4. 












10 










20 


: KATHY’S COLOR PALETTE 






30 


; PUTS ALL 128 COLORS ONTO THE SCREEN 






40 


; CALL FROM BASIC WITH THE FOLLOWING COMMANDS: 






50 


; GR. 5 








60 


; FORI = 0 TO 3: COLOR I: FOR J = 20*I TO 20*1 + 19: PLOT J, 3: 






65 


; DRAWTO J, 39: NEXT J: NEXT I 






70 


; A = USR(1536) 








80 


; BASIC IS STILL USABLE 






90 


; EXIT WITH SYSTEM RESET KEY 






0100 


3 
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0110 


y 






0000 




0120 




* _ 


$0600 


oocc 




0130 


POINTA 


= 


$CC POINTER TO DISPLAY LIST 


OOCE 




0140 


COLCNT 


= 


$CE KEEPS TRACK OF COLOR WE ARE ON 


OOCF 




0150 


DECK 


= 


$CF BIT 0 KEEPS TRACK OF WHICH DECK 


0230 




0160 


DSLSTL 


= 


$0230 O. S. DISPLAY LIST ADDRESS 


D40E 




0170 


NMIEN 


= 


$D40E NON-MASKABLE INTERRUPT ENABLE 


D40F 




0180 


NMIRES 


= 


$D40F NON-MASKABLE INTERRUPT RESET 


D40F 




0190 


NMIST 


= 


$D40F NON-MASKABLE INTERRUPT STATUS 


0200 




0200 


VDSLST 


= 


$0200 DISPLAY LIST INTERRUPT VECTOR 


D01A 




0210 


COLBAK 


= 


$D01A BACKGROUND COLOR REGISTER 


D016 




0220 


COLPFO 


= 


$D016 COLOR REGISTER #0 


D017 




0230 


COLPF1 


= 


$D017 COLOR REGISTER #1 


D018 




0240 


COLPF2 


= 


$D018 COLOR REGISTER » 2 


D40A 




0250 


WSYNC 


= 


$D40A WAIT FOR HORIZONTAL SYNC 


0600 


68 


0260 


SETUP 


PLA 


CLEAN STACK 






0270 


5 










0280 


; SET UP 


POINTER ON PAGE ZERO 






0290 


y 






0601 


AD3002 


0300 




LDA 


DSLSTL 


0604 


85CC 


0310 




STA 


POINTA 


0606 


AD3102 


0320 




LDA 


DSLSTL +1 


0609 


85CD 


0330 




STA 


POINTA + 1 






0340 


3 






060B 


A007 


0350 




LDY 


#$07 POINT TO 3RD MODE BYTE 


060D 


A 98 A 


0360 




LDA 


#$8A NEW MODE BYTE 






0370 


3 










0380 


; STORE 16 DISPLAY LIST INTERRUPT MODE BYTES 






0390 


> 






060F 


9 ICC 


0400 


LOOP 1 


STA 


(POINTA), Y 


0611 


C8 


0410 




INY 




0612 


C017 


0420 




CPY 


#$17 


0614 


D0F9 


0430 




BNE 


LOOP1 






0440 


J 










0450 


; SKIP FOUR BLANK LINES 






0460 


y 






0616 


C8 


0470 




INY 




0617 


C8 


0480 




INY 




0618 


C8 


0490 




INY 




0619 


C8 


0500 




INY 








0510 


3 










0520 


; STORE 16 MORE DISPLAY LIST INTERRUPT MODE BYTES 






0530 


y 






061 A 


91CC 


0540 


LOOP 2 


STA 


(POINTA), Y 


06 1C 


C8 


0550 




INY 




061D 


C02B 


0560 




CPY 


#$2B 


061F 


DOF 9 


0570 




BNE 


LOOP2 






0580 


5 










0590 


; SET UP DISPLAY LIST INTERRUPT VECTOR 






0600 


> 






0621 


A950 


0610 




LDA 


#$50 


0623 


8D0002 


0620 




STA 


VDSLST 


0626 


A906 


0630 




LDA 


#$06 
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0628 


8D102 


0640 




STA 


VDSLST + 1 






0650 


J 








062B 


A900 


0660 




LDA 


#300 




062 D 


85CE 


0670 




STA 


COLCNT 


INITIALIZE COLOR COUNTER 


062F 


85CF 


0680 




STA 


DECK 


INITIALIZE DECK COUNTER 


0631 


8D0FD4 


0690 




STA 


NMIRES 


RESET INTRPT. STATUS REGISTER 


0634 


AD0FD4 


0700 


WAIT 


LDA 


NMIST 


GET INTERRUPT STATUS REGISTER 


0637 


2940 


0710 




AND 


#$40 


HAS VERTICAL BLANK OCCURRED? 


0639 


F0F9 


0720 




beq 


WAIT 


NO, KEEP CHECKING 


063B 


AD0ED4 


0730 




LDA 


NMIEN 


YES, ENABLE DISPLAY LIST 


063E 


0980 


0740 




ORA 


#$80 




0640 


8D0ED4 


0750 




STA 


NMIEN 


THIS ENABLES DLI 


0643 


60 


0760 




RTS 




ALL DONE 






0770 


5 












0780 


; DISPLAY LIST INTERRUPT SERVICE ROUTINE 






0790 


> 








0644 




0800 




* _ 


$0650 




0650 


48 


0810 


DLISRV 


PHA 




SAVE ACCUMULATOR 


0651 


A5CE 


0820 




LDA 


COLCNT 


GET CURRENT COLOR 


0653 


18 


0830 




CLC 






0654 


6910 


0840 




ADC 


#$10 


NEXT COLOR 


0656 


85CE 


0850 




STA 


COLCNT 


SAVE IT 


0658 


D013 


0860 




BNE 


OVER 


END OF DECK? 






0870 


> 












0880 


; END OF DECK, BLACKEN SCREEN 






0890 


5 








065A 


8D0AD4 


0900 




STA 


WSYNC 


WAIT FOR NEXT SCAN LINE 


065D 


8D0AD0 


0910 




STA 


COLBAK 


BLACKEN ALL REGISTERS 


0660 


8D16D0 


0920 




STA 


COLPFO 




0663 


8D17D0 


0930 




STA 


COLPF1 




0669 


E6CF 


0940 




STA 


COLPF2 




066 B 


68 


0950 




INC 


DECK 


NEXT DECK 


066C 


40 


0960 




PLA 




RESTORE ACCUMULATOR 






0970 




RTI 




DONE 






0980 


5 












0990 


; PUT OUT NEXT COLOR, WITH FOUR LUMINOSITIES 






1000 


5 








066D 


A5CF 


1010 


OVER 


LDA 


DECK 


UPPER OR LOWER DECK? 


066F 


2901 


1020 




AND 


#$01 


MASK OFF RELEVANT BIT 


0671 


0A 


1030 




ASL 


A 


SHIFT INTO HIGH LUMINOSITY 


0672 


OA 


1040 




ASL 


A 




0673 


OA 


1050 




ASL 


A 




0674 


OSCE 


1060 




ORA 


COLCNT 


MERGE WITH COLOR NYBBLE 


0676 


8D0AD4 


1070 




STA 


WSYNC 


WAIT FOR NEXT SCAN LINE 


0679 


8D1AD0 


1080 




STA 


COLBAK 


STORE COLOR 


067C 


6902 


1090 




ADC 


#$02 


NEXT HIGHER LUMINOSITY 


067E 


8D16D0 


1100 




STA 


COLPFO 


STORE COLOR 


0681 


6902 


1110 




ADC 


#$02 


NEXT HIGHER LUMINOSITY 


0683 


8D17D0 


1120 




STA 


COLPF1 


STORE COLOR 


0686 


6902 


1130 




ADC 


#$02 


NEXT HIGHER LUMINOSITY 


0688 


8D18D0 


1140 




STA 


COLPF2 


STORE COLOR 


068B 


68 


1150 




PLA 




RESTORE ACCUMULATOR 


068C 


40 


1160 




RTI 




DONE 
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QUICK REFERENCE: 
COMMANDS RECOGNIZED BY 
THE ASSEMBLER EDITOR 




rK TT d * «* — «T Editor cartridge, 
interesting version is presented. ’ " ai <? P resented - In most cases only the most useful or 



EDITOR 

NUMxx, yy 

RENxx, yy 



provides auto line numbering starting at xx in increments 
renumbers all statements in increments of yy, starting 



DELxx, yy 
NEW 

FIND/SOUGHT/xx, yy, A 



REP/OLD/NEW/xx, yy, A 



LIST HP: 

PRINT ffP: 

ENTER NAME 



deletes statement numbers xx through yy 
wipes out source program 

finds and displays all occurrences of the string SOUGHT 
between xx and yy 0 

replaces all occurrences between lines xx and yy of the string 
OLD with the string NEW ° 

lists source program to printer 

prints source program on printer 

retrieves source program from diskette 



SAVE #C: xxxx , yvyy 
LOAD ffC: 

assembler 



saves data in addresses xxxx through yyyy to cassette 
retrieves data from cassette 



Reference 
Page No. 

15 

16 

15 

15 

16 

17 

19 



21 



21 

22 

22 



ASM#D: NAME. SRC, #P:, 



#D: NAME. OBJ 

retrieves source file called NAME. SRC on diskette, lis 
assembly listing to printer, and saves object program 
diskette under filename NAME. OBJ 



debugger 

DR 

CR < „x 
Dxxxx, yvyy 



displays 6502 registers A, X, Y, P, and S. 

puts an x into the Y-register. 

displays contents of addresses xxxx through yyyy 



25 



36 

36 

36 
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Cxxxx < yy 
Mxxxx < yyyy, zzzz 

Vxxxx < yyyy, zzzz 

Lxxxx 

A 

Gxxxx 

Txxxx 

Sxxxx 

X 



puts yy into address xxxx. 

copies memory block yyyy through zzzz into block starting 
at xxxx. 

compares memory block yyyy through zzzz with block 
starting at xxxx, displaying mismatches. 

disassembles memory starting at address xxxx. 

activates mini-assembler (no labels, one line at a time). 

runs object program at xxxx. 

trace; displays G502 registers while running object program 
at address xxxx at readable speed. 

single-steps object program at xxxx, displaying registers, 
return to EDIT mode 
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APPENDIX 11 



MODIFYING DOS I TO MAKE 
BINARY HEADERS COMPATIBLE WITH 
ASSEMBLER EDITOR CARTRIDGE 



The following assembly language program modifies four memory locations in 
“?f 1 t ° make bmai T file headers compatible with the Assembler Editor car- 
Irl a T, her f are tw ° headers (each two bytes long)— one for SAVE and one for 
n- T ° Chan ge f he header bytes from hex 8409 to hex FFFF for full com- 
patibility, type the following modification program. 



EDIT 



10 

20 

30 

40 

50 

60 

70 



*=600 



LDA 


#$FF 


STA 


$2441 


STA 


$2448 


STA 


$14BF 


STA 


$14C0 




END 



To assemble the modification program, type ASM and press 



RETURN 
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To run this program, you must be in DEBUG mode so, type the following. 

• Type BUG and press 

• Type G600 and press 

The screen will display: 




DOS I will now have header bytes that are fully compatible with the Assembler 
Editor cartridge. 



To change DOS I permanently on your diskette: 



1 . 

2 . 

3. 

4. 



Run the Modification Program. 

Type X to get out of BUG. 

Type DOS fiCTSfl to enter DOS. 

Type H to write a fully compatible DOS on diskette. 










CHANGES AND LOCATIONS 

LOCATION PRESENT CONTENTS CHANGE TO 



DECIMAL 


HEX 


DECIMAL 


HEX 


DECIMAL 


HEX 




9281 


2441 


132 


84 


255 


FF 




9288 


2448 


9 


09 


255 


FF 


—LOAD 


5311 


14BF 


132 


84 


255 


FF 




5312 


14CO 


9 


09 


255 


FF 


—SAVE 



Instead of using the Modification Program, you could use BASIC to POKE 
decimal 255 into memory locations 9281, 9288, 5311, and 5312. After making 
the pokes, type DOS to display the DOS Menu. Type II S’sfgffl'ffll to write 

the DOS modification onto diskette. 
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NOTES: 
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